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Preface 


This volume is a companion to the System Administrator's Guide and 
contains all commands that are reserved for exclusive use by system 
administrators. The manual includes the following sections: 

Section Description 

ADM Administrative Commands - used for system administration. 

HW Hardware device manual pages - information about hardware 
devices and device nodes. 

For a complete listing of all commands, refer to the Alphabetized List in 
the User's Reference. 
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INTRO (ADM) 


intro __ 

introduction to system administration commands 

Description 

This section contains the commands that are used to administrate and 
maintain the operating system. These commands are largely root- 
only, meaning that they can only be executed by the super-user (root). 
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ACCEPT(ADM) 


accept, reject _ 

allows/prevents print requests to a lineprinter or class 

of printers 

Syntax 


/usr/lib/accept destinations 
/usr/lib/reject [ -r[ reason ] ] destinations 


Description 


accept allows lp(C) to accept requests for the named destinations. A 
destination can be either a printer or a class of printers. Use lpstat(C ) 
to find the status of destinations. 

reject prevents lp( C) from accepting requests for the named destina¬ 
tions . A destination can be either a printer or a class of printers. Use 
Ipstat(C) to find the status of destinations. The following option is 
useful with reject: 

-r [reason] Associates a reason with disabling (using disable (C)) 
the printer. The reason applies to all printers listed up to 
the next -r option. If the -r option is not present or the -r 
option is given without a reason, then a default reason is 
used. Reason is reported by Ipstat(C). Please see 
disable(C) for an example of reason syntax. 


Files 


/usr/spool/lp/* 

See Also 


enable(C), lp(C), lpadmin(ADM), lpsched(ADM), lpstat(C), 
disable(C) 
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ACCT(ADM) 


acct: acctdisk, acctdusg, accton, 
acctwtmp __ 

overview of accounting and miscellaneous accounting 

commands 


Syntax 


/usr/lib/acct / acctdisk 
/usr/lib/acct/acctdusg [-u file ] [-p file ] 
/usr/lib/acct/accton [file] 

/usr/lib/acct/acctwtmp "reason" 

Description 


Accounting software is structured as a set of tools (consisting of both 
C programs and shell procedures) that can be used to build accounting 
systems. When the system is installed, accounting is initially in the 
“off” state, acctsh (ADM) describes the set of shell procedures built 
on top of the C programs. 

Connect time accounting is handled by various programs that write 
records into /etc/utmp, as described in utmp{ F). The programs 
described in tfcc/ccw(ADM) convert this file into session and charging 
records, which are then summarized by acctmerg( ADM). 

Process accounting is performed by the UNIX system kernel. Upon 
termination of a process, one record per process is written to a file 
(normally /usr/adm/pacct). The programs in acctprc (ADM) summar¬ 
ize this data for charging purposes; acctcms (ADM) is used to summar¬ 
ize command usage. Current process data may be examined using 
acctcom (C). 

Process accounting and connect time accounting [or any accounting 
records in the format described in acct( F)] can be merged and sum¬ 
marized into total accounting records by acctmerg [see tacct format 
m acct(F)]. prtacct [see acctsh ( ADM)] is used to format any or all 
accounting records. 

acctdisk reads lines that contain user ID, login name, and number of 
disk blocks and converts them to total accounting records that can be 
merged with other accounting records. 
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ACCT(ADM) 


acctdusg reads its standard input (usually from find / -print) and com¬ 
putes disk resource consumption (including indirect blocks) by login. 
If -u is given, records consisting of those file names for which 
acctdusg charges no one are placed in file (a potential source for find¬ 
ing users trying to avoid disk charges). If -p is given, file is the name 
of the password file. This option is not needed if the password file is 
/etc/passwd. [See diskusg(ADM) for more details.] 

accton alone turns process accounting off. If file is given, it must be 
the name of an existing file to which the kernel appends process 
accounting records [see acct{ S) and acct{ F)]. 

acctwtmp writes a utmp (F) record to its standard output. The record 
contains the current time and a string of characters that describe the 
reason. A record type of ACCOUNTING is assigned [see utmp(¥)]. 
Reason must be a string of 11 or fewer characters, numbers, $, or 
spaces. For example, the following are suggestions for use in reboot 
and shutdown procedures, respectively: 

acctwtmp uname »/etc/wtmp 
acctwtmp "file save" »/etc/wtmp 


Files 


/etc/passwd used for login name to user ID conversions 
/usr/lib/acct holds all accounting commands listed in this manual 
/usr/adm/pacct current process accounting file 
/etc/wtmp login/logoff history file 


See Also 


acctcms(ADM), acctcom(C), acctcon(ADM), 
acctprc(ADM), acctsh(ADM), diskusg(ADM), 
runacct(ADM), acct(S), acct(F), utmp(F) 

acctmerg(ADM), 

fwtmp(ADM), 

Standards Conformance 


acctdisk is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 


Value Added 



accton is an extension to AT&T System V provided by the Santa Cruz 
Operation. 
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ACCTCMS(ADM) 


acctcms __ 

command summary from per-process accounting 

records 

Syntax 


/usr/lib/acct/acctcms [options] files 

Description 


acctcms reads one or more files , normally in the form described in 
acct( F). It adds all records for processes that executed identically- 
named commands, sorts them, and writes them to the standard output, 
normally using an internal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. 
The output includes command name, number of times executed, 
total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, “hog factor”, char¬ 
acters transferred, and blocks read and written, as in acctcom( C). 
Output is normally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under “***other”. 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in internal sum¬ 
mary format. 

-t Process all records as total accounting records. The default inter¬ 
nal summary format splits each field into prime and non-prime 
time parts. This option combines the prime and non-prime time 
parts into a single field that is the total of both, and provides 
upward compatibility with old (i.e., UNIX System V) style 
acctcms internal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Output a non-prime (offshift) time only command summary. 

When -p and -o are used together, a combination prime and non-prime 
time report is produced. All the output summaries will be total usage 
except number of times executed, CPU minutes, and real minutes 
which will be split into prime and non-prime. 

A typical sequence for performing daily command accounting and for 
maintaining a running total is: 


March 15, 1989 


ACCTCMS-1 











ACCTCMS (ADM) 


ACCTCMS (ADM) 


acctcms file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms -a -s today 


See Also 


acct(ADM), acctcom(C), acctcon(ADM), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), runacct(ADM), acct(S), 
acct(F), utmp(F) 

Notes 


Unpredictable output results if -t is used on new style internal sum¬ 
mary format files, or if it is not used with old style internal summary 
format files. 

Standards Conformance 


acctcms is conformant with: 

AT&T SVLD Issue 2, Select Code 307-127. 
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ACCTCOM (ADM) 


acctcom _ 

search and print process accounting file(s) 

Syntax 

acctcom [ [ options ] [ file ] ]... 

Description 


acctcom reads file, the standard input, or /usr/adm/pacct, in the form 
described by acct{¥) and writes selected records to the standard out¬ 
put. Each record represents the execution of one process. The output 
shows the COMMAND Name, USER, TTYName, START TIME, END 
TIME, REAL (SEC), CPU (SEC), MEAN SIZE(K), and optionally, F 
(the fork/exec flag: 1 for fork without exec), STAT (the system exit 
status), HOG FACTOR, KCORE MIN, CPU FACTOR, CHARS 
TRNSFD, and BLOCKS READ (total blocks read and written). 

The command name is prepended with a # if it was executed with 
super-user privileges. If a process is not associated with a known ter¬ 
minal, a ? is printed in the TTYName field. 

If no files are specified, and if the standard input is associated with a 
terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read; otherwise, the standard input is read. 

If any file arguments are given, they are read in their respective order. 
Each file is normally read forward, i.e., in chronological order by pro¬ 
cess completion time. The file /usr/adm/pacct is usually the current 
file to be examined; a busy system may need several such files of 
which all but the current file are found in /usr/adm/pacct?. The 
options are: 


Show some average statistics about the processes 
selected. The statistics will be printed after the output 
records. 

Read backwards, showing latest commands first. This 
option has no effect when the standard input is read. 
Print the fork/exec flag and system exit status columns 
in the output. 

Instead of mean memory size, show the fraction of total 
available CPU time consumed by the process during its 
execution. This “hog factor” is computed as: 

(total CPU time)/(elapsed time). 

Print columns containing the I/O counts in the output. 
Instead of memory size, show total kcore-minutes. 
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ACCTCOM (ADM) 


-m 

-r 

-t 

-v 

-I line 
-u user 


-g group 

-s time 

-e time 
-S time 
-E time 

-n pattern 

-q 

-o ofile 
-H factor 
-O sec 
-C sec 
-I chars 

Files 


Show mean core size (the default). 

Show CPU factor (user time/(system-time + user-time). 
Show separate system and user CPU times. 

Exclude column headings from the output. 

Show only processes belonging to terminal Idewlline . 
Show only processes belonging to user that may be 
specified by: a user ID, a login name that is then con¬ 
verted to a user ID, a # which designates only those pro¬ 
cesses executed with super-user privileges, or ? which 
designates only those processes associated with 
unknown user IDs. 

Show only processes belonging to group. The group 
may be designated by either the group ID or group 
name. 

Select processes existing at or after time , given in the 
format hr [:min [:sec ]]. 

Select processes existing at or before time . 

Select processes starting at or after time. 

Select processes ending at or before time . Using the 
same time for both -S and -E shows the processes that 
existed at time. 

Show only commands matching pattern that may be a 
regular expression as in ed(C) except that + means one 
or more occurrences. 

Do not print any output records; just print the average 
statistics as with the -a option. 

Copy selected process records in the input data format 
to ofile ; suppress standard output printing. 

Show only processes that exceed factor , where factor is 
the “hog factor” as explained in option -h above. 

Show only processes with CPU system time exceeding 
sec seconds. 

Show only processes with total CPU time, system plus 
user, exceeding sec seconds. 

Show only processes transferring more characters than 
the cut-off number given by chars. 


/etc/passwd ) 

/usr/adm/pacct 

/etc/group 

See Also 


acct(ADM), acctcms(ADM), acctcon(ADM), acctmerg(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), ps(C), runacct(ADM), 
su(ADM), acct(S), acct(F), utmp(F). 
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ACCTCOM (ADM) 

Notes 


ACCTCOM (ADM) 


acctcom reports only on processes that have terminated; use ps(C) for 
active processes. If time exceeds the present time, then time is inter¬ 
preted as occurring on the previous day. 
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ACCTCON(ADM) 


acctcon: acctconl, acctcon2_ 

connect-time accounting 

Syntax 

/usr/lib/acct/acctconl [options] 

/usr/lib/acct/acctcon2 

Description 

acctconl converts a sequence of login/logoff records read from its 
standard input to a sequence of records, one per login session. Its 
input should normally be redirected from /etc/wtmp. Its output is 
ASCII, giving device, user ID, login name, prime connect time 
(seconds), non-prime connect time (seconds), session starting time 
(numeric), and starting date and time. The options are: 

-p Print input only, showing line name, login name, and time (in 
both numeric and date/time formats). 

-t acctconl maintains a list of lines on which users are logged in. 
When it reaches the end of its input, it emits a session record 
for each line that still appears to be active. It normally 
assumes that its input is a current file, so that it uses the current 
time as the ending time for each session still in progress. The 
-t flag causes it to use, instead, the last time found in its input, 
thus assuring reasonable and repeatable numbers for non- 
current files. 

-1 file File is created to contain a summary of line usage showing 
line name, number of minutes used, percentage of total elapsed 
time used, number of sessions charged, number of logins, and 
number of logoffs. This file helps track line usage, identify bad 
lines, and find software and hardware oddities. Hang-up, ter¬ 
mination of login ( M) and termination of the login shell each 
generate logoff records, so that the number of logoffs is often 
three to four times the number of sessions. See init( M) and 
utmp{ F). 

-o file File is filled with an overall record for the accounting period, 
giving starting time, ending time, number of reboots, and num¬ 
ber of date changes. 

acctcon2 expects as input a sequence of login session records and 
converts them into total accounting records [see tacct format in 
acct( F)]. 
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ACCTCON(ADM) 

Examples 


ACCTCON(ADM) 


These commands are typically used as shown below. The file ctmp is 
created only for the use of acctprc (ADM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp | sort +ln +2 >ctmp 
acctcon2 <ctmp | acctmerg >ctacct 

Files 


/etc/wtmp 


See Also 


acct(ADM) acctcms(ADM), acctcom(C), acctmerg(ADM), 

acctprcfADM) acctsh(ADM), fwtmp(ADM), init(M), runacct(ADM), 
acct(S), acct(F), utmp(F) 

Notes 


The line usage report is confused by date changes. 
fwtmp( ADM)] to correct this situation. 

Use wtmpfix [see 

Standards Conformance 



acctconl and acctcon2 are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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ACCTMERG (ADM) 


acctmerg _ 

merge or add total accounting files 

Syntax 

/usr/lib/acct/acctmerg [options] [file]... 


Description 

acctmerg reads its standard input and up to nine additional files, all in 
the tacct format [see acct (F)] or an ASCII version thereof. It merges 
these inputs by adding records whose keys (normally user ID and 
name) are identical, and expects the inputs to be sorted on those keys. 
Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more precise nota¬ 
tion for floating point numbers. 


Examples 


The following sequence is useful for making “repairs to any file kept 
in this format: 

acctmerg -v <filel >file2 

edit file! as desired ... 
acctmerg -i <file2 >filel 


See Also 


acct(ADM), acctcms(ADM), acctcom(C), acctcon(ADM), 
acctprc(ADM), acctsh(ADM), fwtmp(ADM), runacct(ADM), acct(S), 
acct(F), utmp(F) 

Standards Conformance 


acctmerg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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ACCTON(ADM) 


accton 


turns on accounting 

Syntax 


accton [file] 


Description 


accton turns on and off process accounting. If no file is given then 
accounting is turned off. If file is given, the kernel appends process 
accounting records. (See acct (S) and acct (F)). 

Files 


/etc/passwd 

Used for login name to user ID conversions 

Aisr/adm/pacct 

Current process accounting file 

Aisr/adm/sulogin 

Super-user login history file 

/etc/wtmp 

Login/logout history file 

See Also 


acctcom(ADM), acct(S), acct(F), su(C), utmp(F) 

Value Added 



accton is an extension to AT&T System V developed by the Santa 
Cruz Operation. 
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acctprc: acctprcl, acctprc2_ 

process accounting 

Syntax 

/usr/lib/acct/acctprcl [ctmp ] 

/usr/lib/acct / acctprc2 

Description 

acctprcl reads input in the form described by acct( F), adds login 
names corresponding to user IDs, then writes for each process an 
ASCII line giving user ID, login name, prime CPU time (tics), non- 
prime CPU time (tics), and mean memory size (in memory segment 
units). If ctmp is given, it is expected to contain a list of login ses¬ 
sions, in the form described in acctcon (ADM), sorted by user ID and 
login name. If this file is not supplied, it obtains login names from the 
password file. The information in ctmp helps it distinguish among 
different login names that share the same user ID. 

acctprc2 reads records in the form written by acctprcl , summarizes 
them by user ID and name, then writes the sorted summaries to the 
standard output as total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct | acctprc2 >ptacct 

Files 


/etc/passwd 

See Also 

acct(ADM), acctcms(ADM), acctcom(C) acctcon(ADM), 
acctmerg(ADM), acctsh(ADM), cron(C), fwtmp(ADM), 
runacct(ADM), acct(S), acct(F), utmp(F) 
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ACCTPRC(ADM) 

Notes 


ACCTPRC(ADM) 


Although it is possible to distinguish among login names that share 
user IDs for commands run normally, it is difficult to do this for those 
commands run from cron (C), for example. More precise conversion 
can be done by faking login sessions on the console via the acctwtmp 
program in am (ADM). 

Standards Conformance 


acctprcl and acctprc2 are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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acctsh: chargefee, ckpacct, dodisk, 
lastlogin, monacct, nulladm, prctmp, 
prdaily, prtacct, runacct, shutacct, 
startup, turnacct _ 

shell procedures for accounting 

Syntax 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk [-o] [files ...] 

/usr/lib/ acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 
/usr/lib/acct/prdaily [-1] [-c] [ mmdd ] 

/usr/lib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [mmdd] [mmdd state ] 

/usr/lib/acct/shutacct [ "reason" ] 

/usr/lib/acct/startup 

/usr/lib/ acct/turnacct on | off | switch 

Description 

chargefee can be invoked to charge a number of units to login-name. 
A record is written to /usr/adm/fee to be merged with other account¬ 
ing records during the night. 

ckpacct should be initiated via cron(C). It periodically checks the 
size of /usr/adm/pacct. If the size exceeds blocks, 1000 by default, 
turnacct will be invoked with argument switch. If the number of free 
disk blocks in the /usr file system falls below 500, ckpacct will auto¬ 
matically turn off the collection of process accounting records via the 
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off argument to turnacct. When at least this number of blocks is 
restored, the accounting will be activated again. This feature is sensi¬ 
tive to the frequency at which ckpacct is executed, usually by cron. 

dodisk should be invoked by cron to perform the disk accounting 
functions. By default, it will do disk accounting on the special files in 
/etc/default/filesys . If the -o flag is used, it will do a slower version of 
disk accounting by login directory. Files specify the one or more 
filesystem names where disk accounting will be done. If files are 
used, disk accounting will be done on these file systems only. If the -o 
flag is used, files should be mount points of mounted filesystem. If 
omitted, they should be the special file names of mountable file sys¬ 
tems. 

lastlogin is invoked by runacct to update /usr/adm/acct/sum/log- 
inlog, which shows the last date on which each person logged in. 

monacct should be invoked once each month or each accounting peri¬ 
od. Number indicates which month or period it is. If number is not 
given, it defaults to the current month (01-12). This default is useful if 
monacct is to executed via croniC) on the first day of each month. 
monacct creates summary files in /usr/adm/acct/fiscal and restarts 
summary files in /usr/adm/acct/sum. 

nulladm creates file with mode 664 and ensures that owner and group 
are adm. It is called by various accounting shell procedures. 

prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctcon (ADM). 

prdaily is invoked by runacct to format a report of the previous day’s 
accounting data. The report resides in /usr/adm/acct/sum/rprttfWicW 
where mmdd is the month and day of the report. The current daily 
accounting reports may be printed by typing, prdaily. Previous days’ 
accounting reports can be printed by using the mmdd option and speci¬ 
fying the exact report date desired. The -1 flag prints a report of 
exceptional usage by login id for the specified date. Previous daily 
reports are cleaned up and therefore inaccessible after each invocation 
of monacct . The -c flag prints a report of exceptional resource usage 
by command, and may be used on current day’s accounting data only. 

prtacct can be used to format and print any total accounting (facet) 


runacct performs the accumulation of connect, process, fee, and disk 
accounting on a daily basis. It also creates summaries of command 
usage. For more information, see runacct(ADM). 

shutacct is invoked during a system shutdown to turn process account¬ 
ing off and append a “reason” record to /etc/wtmp. 
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startup is called by /etc/init.d/acct to turn the accounting on when- 
ever the system is brought to a multiuser state. 

turnacct is an interface to accton [see acct( ADM)] to turn process 
accounting on or off. The switch argument turns accounting off, 
moves the current /usr/adm/pacct to the next free name in 
/usr/adm/pacctmcr (where incr is a number starting with 1 and incre- ■ 
menting by one for each additional pacct file), then turns accounting 
back on again. This procedure is called by ckpacct and thus can be 
taken care of by the cron and used to keep pacct to a reasonable size. 
acct starts and stops process accounting via init and shutdown accord¬ 
ingly. 


Files 


accumulator for fees 
current file for per-process accounting 
used if pacct gets large and during execution 
of daily accounting procedure 
login/logoff summary 

contains the limits for exceptional usage by 
login id 

/usr/lib/acct/ptecms.awk contains the limits for exceptional usage by 
command name 
working directory 

holds all accounting commands listed in 
(ADM) 

summary directory, should be saved 


/usr/adm/fee 

/usr/adm/pacct 

/usr/adm/pacct* 

/etc/wtmp 

/usr/lib/acct/ptelus.awk 


/usr/adm/acct/nite 

/usr/lib/acct 


/usr/adm/acct/ sum 

See Also 


acct(ADM), acctcms(ADM), acctcom(ADM), acctcon(ADM), 
acctmerg(ADM), acctprc(ADM), cron(C), diskusg(ADM), 
fwtmp(ADM), runacct(ADM), acct(S), acct(F), utmp(F) 

Standards Conformance 

chargefee is conformant with: 

ANSI X3.159-198X C Language Draft Standard, May 13,1988. 


ckpacct, lastlogin, prctmp, runacct and shutacct are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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adfmt 

formats SCSI hard disks 

Syntax 

/usr/bin/adfmt device_name 

Description 


The adfmt command issues a format command to the SCSI disk de¬ 
vice jtame. devicejiame should be the character-special device 
representing the whole SCSI disk, for example, Idev/rhdOO. 

Notes 


SCSI disks with embedded controllers are formatted as part of the 
manufacturing test procedure. Using adfmt on these disks is unneces¬ 
sary. 

Files 


/dev/rhd?0 

See Aiso 

scsi(HW), hd(HW) 

Value Added 


adfmt is an extension of AT&T System V provided by The Santa Cruz 
Operation, Inc. 
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addxusers 

create new user accounts given a XENIX-style pass¬ 

word file 

Syntax 

/tcb/bin/addxusers [ -e ] [ -s ] [ -t type ] [ file ] 

Description 

addxusers reads the specified file , which should be in XENIX 
passwd( F) format, and creates the indicated accounts by making 
equivalent entries in the system’s /etc/passwd file and Protected Pass¬ 
word database. The auth subsystem and chown kernel authorizations 
are required to run addxusers. If no file is given, addxusers does not 
attempt to add any new users and only performs certain consistency 
checks on the existing user accounts. A file of - means that the stan¬ 
dard input should be read. 

Login names must begin with a lower case letter, must not already 
exist, must not contain a slash (“/”), and must not be longer than 8 
characters. 

Numeric user IDs must not be already assigned, and must be in the 
range 0 to 60000 (inclusive). 

« 

Numeric group IDs must be in the range 0 to 60000 (inclusive). 
Groups which are missing from the file /etc/group are warned about, 
as is membership in a group associated with a protected subsystem. 

Encrypted passwords are preserved; that is, users will be able to use 
their old XENIX passwords to log onto the new system. 

Any password aging information which is present is translated into the 
equivalent expiration parameters. 

The comment field, initial working directory (home directory), and 
shell program are preserved. Missing or inaccessible directories and 
shells are warned about, as are non-absolute pathnames. Users should 
not share home directories. 
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The -t option sets the type of each created user; if omitted, each user is 
classified as an “individual” person. The legal type values are: 


Number 

User type values 

Equivalent names 

Comments 

0 

root 

superuser 

All-powerful user (numeric ID 0). 

1 

operator 


Classifications of anonymous sys- 
tern administration accounts. 

2 

sso 

security officer 

3 

admin 

administrator 

4 

pseudo 

pseudo-user 

General-purpose anonymous user. 

5 

general 

individual 

A human’s personal account. 

6 

retired 


An account which is no longer used. 


A “retired” user cannot log in and cannot be un-retired. No user may 
su( C) to an “individual” account. 


Normally, only minimal checks for corruption are done on the existing 
/etc/passwd file before the new users are added: Checks are only 
done for duplicated login names or numeric user IDs, and bad format. 
(These are all fatal errors, and prevent any new users from being 
added.) The -e option causes the same checks which are applied to 
new users to be applied to the existing users (except for membership 
in a protected subsystem group). The -s option checks the existing 
users for being a member of a protected subsystem group. As with 
new user accounts, not all of the problems which may be discovered 
are fatal (many are only warnings). 

Duplicated group names or numeric group IDs in the /etc/group file 
are warned about. However, if a protected subsystem group is so cor¬ 
rupted, this is a fatal error (no users are added). 

Example 


The following steps should be performed when migrating a commun¬ 
ity of users from a XENIX system: 

1. Back up the home directories of the users on the XENIX system 
using cpio(C) or tar(C). 

2. Make a copy of /etc/passwd and /etc/group from the XENIX sys¬ 
tem. (Do not back up these files using absolute pathnames. For 
example, if your accounts are in /usr, run your backup command 
from that directory, not from /.) 
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3. After making certain you are in single user mode, extract the 
backup of the user’s home directories on the new system. For 
example, if your user accounts reside in /usr, the files should be 
extracted in /usr on the new system. (Note that if you are using /u 
for your accounts, you must mount it before extracting your back¬ 
ups.) 

4. Extract the copy of the passwd and group files in a temporary 
directory; for example, /tmp/passwd and /tmp/group. Be careful 
not to overwrite the /etc/passwd and /etc/group files on the new 
system. 

5. Edit /tmp/passwd to remove “system” accounts (such as root and 
bin) and any accounts that already exist on the new system. 

6. Separate the remaining accounts in /tmp/passwd (which are to be 
added to the new system) into different files by user type. For 
example, place all “pseudo-users” in a file called /tmp/pseudo and 
all “individual” humans in /tmp/individual. 

7. In your sorted /tmp account files, you should then change login 
names, numeric user IDs, numeric group IDs, initial working direc¬ 
tories, and shell programs as necessary to prevent conflicts with 
any accounts already on the new system. (If any numeric user or 
group IDs are changed, it may be desirable to chown(C) or 
chgrp( C) the appropriate home directories on the new system and 
their contents.) 

8. Merge /tmp/group (the saved copy of the XENIX system’s 
/etc/group) with the new system’s /etc/group; see group(F). 
Again, make certain you are still in single-user mode; if /etc/group 
is modified while in multi-user mode, no-one will be allowed to 
log in. 

9. Run addxusers : 

addxusers -t pseudo-user /tmp/pseudo 2>&1 I tee -a /tmp/errors 
addxusers -t individual /tmp/individual 2>&1 I tee -a /tmp/errors 

It is advisable to save the standard output and error output of 
addxusers (as shown above) for later analysis and correction. 

Finally, use the Accounts-»User-»Examine menu of 

sysadmsh( ADM) to customize the newly-created accounts as needed. 

The authorizations may need customization, and accounts which are 

neither individuals nor retired should have an “account which may 

su” assigned. 
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See Also 


ADDXUSERS(ADM) 


authcap(F), chgrp(C), chown(C), cpio(C), group(F), passwd(F), su(C), 
sysadmsh(ADM), tar(C), tee(C) 

Notes 


When logging in, XENIX truncates passwords to eight (8) characters; 
SCO System V does not. Therefore, the user must not type more than 
eight characters when the password from the XENIX system is in 
effect. 

Passwordless accounts and other liberties XENIX allows are more re¬ 
stricted in SCO System V. To continue to use such poor security prac¬ 
tices requires customizing the system defaults or the insecure 
accounts. 

Some standard accounts shipped with the system provoke warnings 
when the -e or -s options are specified. 

Some vendor’s systems support specifying a nice( S) value in the com¬ 
ment field, or doing a chroot(S) to the home directory (called a 
sublogin). Both constructions are understood by addxusers , albeit 
sublogins are not supported in SCO System V and cause a warning. 
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asktime 

prompts for the correct time of day 

Syntax 

/etc/asktime 

Description 

This command prompts for the time of day. You must enter a legal 
time according to the proper format as defined below: 

[\yy]mmdd] hhmm 

Here the first mm is the month number; dd is the day number in the 
month; hh is the hour number (24-hour system); the second mm is the 
minute number; yy is the last 2 digits of the year number and is 
optional. The current year is the default if no year is mentioned. 

Examples 


This example sets the new time, date, and year to “11:29 April 20, 
1985”. 

Current system time is Wed Nov 3 14:36:23 PST 1985 
Enter time ( [yymmdd]hhmm) : 8504201129 

Diagnostics 


If you enter an illegal time, asktime prompts with: 
Try again: 


Notes 


asktime is normally performed automatically by the /etc/rc2 system 
startup scripts immediately after the system is booted; however, it 
may be executed at any time. The command is privileged, and can 
only be executed by the super-user. 

Systems which autoboot will invoke asktime automatically on reboot. 
On these systems, if you don’t enter a new time or press return within 
1 minute of invoking asktime , the system will use the time value it 
has. If RETURN alone is entered, the time is unchanged. 
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Value Added 


ASKTIME (ADM) 


asktime is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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atcronsh _ 

at and cron administration utility 

Syntax 

/usr/lib/sysadm/atcronsh 

Description 


atcronsh is the screen interface invoked by the sysadmsh{ ADM) 
Jobs—Authorize selection. It is used to specify users allowed to use 
the cron(C), at{ C) and batch{C) commands. It also allows the at(C) 
and batch(C) prototype files to be edited. 

The program allows a system default for both cron{ C) and at( C) and 
batchiC) to be given. The defaults can be: 

• none - No user authorized 

• allow - All users allowed to use the commands unless a user is spe¬ 
cifically denied 

• deny - All users denied to use the commands unless a user is spe¬ 
cifically authorised 

The default setting decides whether an allow or deny file is to be used 
(deny file means msr/lib/cron/cron.deny or at.deny, allow file means 

/usr/lib/cron/cron.deny or at.deny). 

For each user (unless the none system default has been chosen), a spe¬ 
cific authorization for both cron( C) and at(C) and batch(C) may be 
given. The allow and deny files are interpreted as follows: 

• if an allow file exists, and the user name appears in it, the user 
is allowed access. 

• if an allow file exists, access is denied 

• if a deny file exists and the user name appears in it, access id 
denied 

• if a deny file exists, access is allowed 

• access is denied 
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Files 


/usr/lib/cron/cron.allow 

/usr/lib/cron/cron.deny 

/usr/lib/cron/at.allow 

/usr/lib/cron/at.deny 


See Also 


auditsh(ADM), authsh(ADM), at(C), 
cron(C), lpsh(ADM), sysadmsh(ADM) 

backupsh(ADM), batch(C), 

Notes 


Invoking atcronsh(ADM) is not recommended; use the 
sysadmsh(ADM) Jobs—>Authorize selection. 

Value Added 



atcronsh is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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auditcmd __ 

command interface for audit subsystem activation, ter¬ 

mination, statistic retrieval, and subsystem notification 

Syntax 


auditcmd [ -e ] [ -d ] [ -s ] [ -c ] [ -m ] [ -q ] 

Description 


The auditcmd utility is used to control the audit subsystem. This com¬ 
mand may only be executed by processes with the configaudit kernel 

authorization since the audit device is used. 

auditcmd allows the specification of one of the following options: 

-e Enable the audit subsystem for audit record generation. The 
enabling of the audit subsystem initializes subsystem parame¬ 
ters from the /tcb/files/audit/audit_parms file. This file is 
established using the auditif(ADM) command. 

-s Inform the audit subsystem that a system shutdown is in pro¬ 
gress. The subsystem will continue audit record generation to 
a temporary directory on the root file system. The audit dae¬ 
mon is also modified so that it will survive the shutdown. The 
subsystem will continue to generate audit records until dis¬ 
abled. 

-d Disable the audit subsystem. All audit record generation 
ceases and a termination record is written to the audit trail. 
This record results in the termination of the audit daemon. 
The subsystem properly synchronizes to insure that the audit 
daemon has read all records from the audit trail before the 
system is allowed to terminate. 

-m Inform the audit subsystem that multi-user run state has been 
achieved and that alternate audit directories specified by the 
administrator using auditif are now mounted and available. 

-c Retrieve audit subsystem statistics from the audit device. 

-q Perform the specified option silently. Do not report errors 
attributable to the audit subsystem not being enabled at the 
moment. 
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See Also 


audit(HW), “Maintaining System Security,” chapter of the System 
Administrator's Guide 

Diagnostics 


auditcmd returns 0 on success, 1 on command line argument error, and 
-1 on failure actions. Reasons for failure include parameter file incon¬ 
sistencies, lack of permission, and security database inconsistency. 

Value Added 


auditcmd is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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auditd__ 

read audit collection files generated by the audit sub¬ 
system and compact the records 

Syntax 


auditd [ -y ] [ -n ] 

Description 


auditd is the audit daemon process which is spawned whenever the 
audit subsystem is enabled. The audit subsystem continually generates 
audit records writing them to intermediate files called audit collection 
files. At any time, there may be many collection files since the subsys¬ 
tem continually switches files to ensure that no single file grows 
excessively large. 

The daemon is responsible for reading the audit collection file records 
from the subsystem, compacting them to provide space savings, and 
writing the compacted records to files which will later be used for 
reduction. To read the records from the subsystem, the daemon uses 
the /dev/auditr device. The daemon exclusively reads this file which 
is managed by the subsystem. Each read request returns a block of 
data from a collection file. The audit subsystem insures that the data is 
returned in the proper order and also handles file management associ¬ 
ated with the multiple collection files. This provides the daemon with 
a single read focal point. 

As a block of data is returned to the daemon, it is optionally com¬ 
pacted and the record along with its size prepended is written to the 
current audit output file. Like the audit subsystem, the daemon is 
capable of writing many different output files in a number of adminis¬ 
trator specified directories to avoid overflowing any one file system. 
As each output file is written, the daemon records the name in a log 
file which is used by the reduction program. This log file provides an 
output file trail alleviating the need for the administrator to keep up 
with file generation or to recreate the sequence of output file writing. 
The compaction of output files and the selection of audit directories is 
controlled by the administrator interface utility auditsh(ADM). 

Each time the audit subsystem is enabled, a new audit session is creat¬ 
ed. The session is identified by a session ID which is used to stamp the 
output files generated by the audit daemon and the log file that identi¬ 
fies them, auditif is used to examine daemon log files in the 
/tcb/ffiles/ audit directory to identify the session and the date/time of 
the start and end of the session. In this manner, the administrator need 
not know the session ID but only the dates for which data reduction is 
desired. 
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When the daemon is started, a recovery mechanism is invoked to 
determine if the previous audit session was terminated normally. If 
abnormal termination occurred, there may be audit records written by 
the subsystem to collection files that were not read by the daemon and 
compacted to an audit output file. The daemon recovery mechanism 
provides the capability to recover these records and update the output 
files from the previous session as necessary. The recovery mechanism 
will interactively query whether recovery is desired if abnormal termi¬ 
nation occurred. The -y and -n options may be to used avoid the 
interactive question. 

The daemon also provides a mechanism whereby applications that are 
not privileged to open and write audit records to the audit device are 
able to send the daemon audit records. These are, in turn, written to to 
the audit subsystem. To provide this service, the daemon creates a 
message queue which only certain applications with specific permis¬ 
sion are able to send messages to. When one of the applications 
wishes to generate an audit record using this mechanism, the record is 
first constructed and then written to the message queue. The specific 
message queue is identified in the file 
/tcb/files/audit/auditdmninfo. This file contains the audit dmninfo 
structure which is defined in the include file sys/audit.h. The first 
field is the process ID of the daemon and the second is the message 
queue identifier. After the message has been written to the queue by 
the application, the application will generate a SIGUSR1 to the dae¬ 
mon indicating a message is waiting. The daemon responds by reading 
the message queue and writing the record to the audit subsystem de¬ 
vice. 

Files 


/dev/auditr 

/dev/auditw 

/tcb/files/ audit/audit_dmninfo 
/tcb/files/ audit/C AFLOG.xxxxxx 

See Also 


audit(HW), “Maintaining System Security,” chapter of the System 
Administrator’s Guide 

Diagnostics 


Upon successful completion at the termination of auditing by the sub¬ 
system, the program exits with a status of 0. Otherwise, a diagnostic 
message is printed and the program exits with a status of-1. 
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AUDITD (ADM) 


auditd is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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auditsh _ 

menu driven audit administration utility 

Syntax 

/usr/lib/sysadm/auditsh 

Description 


auditsh is the screen interface invoked by the sysadmsh( ADM) 
System—>Audit selection. This selection controls the audit subsystem, 
allowing establishment of audit subsystem initialization parameters, 
specification of criteria for selecting output records during reduction, 
report generation, dynamic changing of subsystem parameters, and 
backup and restore of compacted audit output files. 

If the environment variable PAGER is set, the specified program is 
used to display reports sent to the terminal. 


See Also 


atcronsh(ADM), auditcmd(ADM), auditd(ADM), authsh(ADM), 
backupsh(ADM), lpsh(ADM), reduce(ADM), sysadmsh(ADM) 

Notes 


Invoking auditsh(ADM) is not recommended; use the 
sysadmsh( ADM) System-»Configure->Audit selection. 


Value Added 

auditsh is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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authck 


check internal consistency of Authentication database 

Syntax 


authck [ -p ] [ -t ] [ -s ] [ -f ] [ -c ] [ -a ] [ -v ] 

Description 


authck checks both the overall structure and internal field consistency 
of all components of the Authentication database. It reports all prob¬ 
lems it finds. The options and tests are as follows: 

-p Check the Protected Password database. A number of tests are 
performed. The Protected Password and /etc/passwd are 
checked for completeness such that neither contains entries not 
in the other. Once this is done, the fields common to the Pro¬ 
tected Password database and /etc/passwd are checked to make 
sure they agree. Then, fields in the Protected Password database 
are checked for reasonable values. For instance, all time stamps 
of past events are checked to make sure they have times less 
than that returned by time (S). 

-t The fields in the Terminal Control database are checked for rea¬ 
sonable values. All time stamps of past events are checked to 
make sure they have times less than returned by time . 

-s The Protected Subsystem database files are checked to ensure 
they correctly reflect the subsystem authorization entries in the 
Protected Password database. Each name listed in each subsys¬ 
tem file is verified against the Protected Password entry with the 
same name, so that no authorization is inconsistent between the 
files. Also, each Protected Password entry is scanned to ensure 
that all the privileges listed do in fact get reflected in the Pro¬ 
tected Subsystem database. If any inconsistencies are found, 
the administrator is given the option of fixing the Subsystem 
database automatically. 

-a This option is shorthand for turning on all the -p, -t, and -s, 
options. 

-v This options provides running diagnostics as the program 
proceeds. It also produces warnings on events that should not 
occur but otherwise do not harm the Authentication database 
and the routines operating on it. 


March 15, 1989 


AUTHCK-1 







AUTHCK (ADM) 

Files 


AUTHCK(ADM) 


/etc/passwd - System password file 
/tcb/files/auth/*/* - Protected Password database 
/etc/auth/system/ttys - Terminal Control database 
/etc/auth/system/files - File Control database 
/etc/auth/subsystems/* - Protected Subsystem database 
/etc/auth/system/default - System Defaults database 

See Also 


integrity(ADM), getprpwent(S), getprtcent(S), getprfient(S), 
getprdfent(S), authcap(F), subsystem(S), “Maintaining System Secu¬ 
rity,” chapter of the System Administrator’s Guide 

Value Added 


authck is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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authsh 


administrator interface for authorization subsystem 

Syntax 


/usr/Ub/sysadm/authsh 

Description 


authsh is the screen interface invoked by the sysadmsh(ADM) 
Accounts selection to administer the authorization subsystem. It is a 
full screen menu driven interface that provides the functions necessary 
to control the generation and maintenance of user and system pass¬ 
words, the terminal database configuration, terminal and account 
locking, and the generation of administrator reports on system 
activity. 

The functions supported by the main level menu are: 


User 

This category of screen interfaces is provided for the 
setup and maintenance of user accounts and user 
account passwords. The screens are used to add, update, 
display, and delete user accounts from the system. 
Also, modifications to user account passwords or 
modifications to the various criteria controlling the 
generation of account passwords is accomplished using 
this menu option. 

System 

These options are provided for the maintenance of 
system-wide parameters like default privileges, pass¬ 
word expiration, password lifetime, single user pass¬ 
word requirement, restrictive password generation, and 
the delay time between login attempts. These parame¬ 
ters apply on a global system basis rather than a user 
account basis. 

Terminals 

The terminal database interface screens are used for the 
maintenance of the database entries to support the addi¬ 
tion, deletion, and update of terminal information. 
Additionally, this category includes the necessary 
screens for setting and clearing locks on specific termi¬ 
nals. 

Reports 

This category provides the administrator with a method 
of generating various reports on system activity. Report 
types include password database, terminal database, 
and login activity reports. 
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The interface program is located in the trusted computing base direc¬ 
tory /tcb/bin. 

See Also 


passwd(C), “Maintaining System Security,” chapter of the System 
Administrator’s Guide 

Files 


/etc/group, 

/etc/passwd, 

/tcb/files/auth/[a-z]/* 

/tcb/files/biodb/[a-z]/*, 

/tcb/files/biodb/schema, 

Notes 


Invoking authsh(ADM) is not recommended; use the sysadmsh{ ADM) 
Accounts selection. 

Value Added 


authsh is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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autoboot _ 

automatically boots the system 

Description 


The system can be set up to go through the boot stages automatically 
(as defined in /etc/default/boot) when the computer is turned on 
(booted), provided no key is pressed at the boot( HW) prompt. 

If boot times out and AUTOBOOT=YES, then the word “auto” is 
passed in the boot string and init(M ) is passed a -a flag , 

In addition, the TIMEOUT entry can be set to specify the number of 
seconds to wait before timing out. 

The autoboot procedure checks the file /etc/default/boot for the fol¬ 
lowing instructions on autobooting: 


AUTOBOOT=YES or NO 


MULTIUSER=YES or NO 


PANICBOOT=YES or NO 


RONLYROOT=YES or NO 


DEFB OOTSTR=bootstring 


Whether or not boot( HW) times out 
and loads the kernel, boot looks for 
this variable in the /etc/default/boot 
file on its default device. 

Whether or not init( M) invokes 
sulogin or proceeds to multiuser 
mode. 

Whether or not the system reboots 
after a panic(). This variable is read 
from /etc/default/boot by init. 

Whether or not the root filesystem is 
mounted readonly. This must be 
used only during installation, and not 
for a normal boot. It will effectively 
prevent writing to the filesystem. 

Set default bootstring to bootstring. 
This is the string used by boot when 
the user presses <RETURN> only to 
the “Boot.” prompt, or when boot 
times out. 


March 15, 1989 


AUTOBOOT-1 







AUTOBOOT (ADM) 


AUTOBOOT (ADM) 


SYSTTY=jc 


If jc is 1, the system console device is 
set to the serial adapter at COM. If x 
is 0, the system console is set to the 
main display adapter. 


SLEEPTIME=« 


Sets the time (in seconds) between 
calls to sync. 



TIMEOUT=/i 


where n is the number of seconds to 
timeout at the “Boot:” prompt 
before booting the kernel (if 
AUTOBOOT=YES). If TIMEOUT is 
unspecified, defaults to one minute. 


If either the /etc/default/boot file or the variable needed cannot be 
found, the variable is assumed to be NO. However, if the filesystem 
cannot be found, PANICBOOT is set to YES. 

If the UNIX mail system, mail(C) y is installed on the system, the output 
of the boot sequence is mailed to root. Otherwise, the system 
administrator should check the file /etc/bootlog for the boot sequence 
output. The output of fsck (ADM) is temporarily saved in the file 
/dev/recover before it is moved to /etc/bootlog and finally may be 
sent to the system administrator via mail. 

Other boot options which take affect during autoboot are documented 
on the boot{ HW) manual page. 



Files 


/etc/bootlog 

/etc/default/boot 

/etc/rc2 


boot output log for autobooting systems 


boot information file 


instructions for entering multiuser mode, 
includes mounting and checking additional 
filesystems 


/etc/sulogin 


executed at startup, prompts the user to press 
Ctrl-d for multiuser mode or to enter the root 
password for maintenance mode 


/dev/recover 

/dev/scratch 


allows saving of fsck output 


temporary fsck file for large filesystems 


See Also 



boot(HW), fsck(ADM), init(M) 
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Notes 


AUTOBOOT (ADM) 


The utilities invoked during the boot procedure are passed the -a flag 
and time out only when the system autoboots . For example, 
asktime (ADM) times out after 30 seconds when the system autoboots, 
but waits for a response from the user any other time it is invoked. 

The previous boot modes of AUTO=CLEAN, DIRTY, NEVER have 
been retained for backwards compatibility, but are ignored if any of 
the newer modes are present. 

Value Added 


autoboot is an extension to AT&T System V developed by the Santa 
Cruz Operation. 
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backup__ 

performs UNIX backup functions 

Syntax 

backup [ -t ] [ -p I -c I -f files I -u "userl [ user2]" ] -d device 

backup -h 

Description 

The UNIX backup utility is a front-end for the cpio{ C) utility. Use 

restore^ ADM) to restore backups made with this utility. It is not 

recommended for routine system backups; use the sysadmsh{ ADM) 

interface for system backups. 

-h produces a history of backups. Tells the user when the last com¬ 
plete and incremental/partial backups were done. 

-c complete backup. All files changed since the system was installed 
are backed up. 

-p incremental/partial backup. This option backs up only the files 
that have been modified since the date of the last backup. A com¬ 
plete backup must be done before a partial backup. 

-f backup files specified by the <files> argument. File names may 
contain characters to be expanded ( i.e., *, .) by the shell. The 
argument must be in quotes. 

-u backup a user’s home directory. All files in the user s home direc¬ 
tory will be backed up. At least one user must be specified but it 
can be more. The argument must be in quotes if more than one 
user is specified. If the user name is "all , then all the user s home 
directories will be backed up. 

-d used to specify the device to be used. It defaults to 
/dev/rdsk/f0ql5d (the 1.2M floppy). 

-t used when the device is a tape. This option must be used with the 
-d option when the tape device is specified. 
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BACKUP(ADM) 


A complete backup must be done before a partial backup can be done. 
Raw devices rather than block devices should always be used. The 
program can handle multi-volume backups. The program will prompt 
the user when it is ready for the next medium. The program will give 
you an estimated number of floppies/tapes that will be needed to do 
the backup. Floppies MUST be formatted before the backup is done. 
Tapes do not need to be formatted, except mini-cartridge tapes. If 
backup is done to tape, the tape must be rewound. 

xbackup is the equivalent utility for XENIX filesystems. 
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backupsh _ 

menu driven backup administration utility 

Syntax 

/usr/lib/sysadm/backupsh 

Description 


backupsh is the screen interface invoked by the sysadmsh{ ADM) 
Backups selection to administer the backup subsystem, backupsh 
allows scheduled and non scheduled backups to be taken. Complete 
filesystems or single files or directories may also be restored. It also 
allows the /usr/Hb/sysadmin/schedule file to be edited. 

Backupsh can be used with both UNIX and XENIX filesystems. If a 
UNIX filesystem is being used then backupsh calls cpio{ C), if a 
XENIX filesystem is being used then backupsh calls xbackup( ADM) 
or xrestore( ADM). 

Refer atcronsh(ADM) for details of environment variables that 
backupsh uses, the usage is the same except that backpsh uses the spe¬ 
cific variable BACKUP instead of ATCRON. 

Files 


/usr/lib/sysadmin/schedule 

See Also 


atcronsh(ADM) auditsh(ADM), authsh(ADM), at(C), batch(C), 
cpio(C), cron(C), backup(ADM), lpsh(ADM), restore(ADM), 
sysadmsh(ADM) 

Notes 


Invoking backupsh(ADM) is not recommended; use the 
sysadmsh( ADM) Backups selection. 

Value Added 


backupsh is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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badtrk __ 

scans fixed disk for flaws and creates bad track table 

Syntax 


badtrk [ -e [ -m max ] ] [ -s qtdn ] [ -f device ] 


Description 


Used chiefly during system installation, badtrk scans the media sur¬ 
face for flaws, creates a new bad track table, prints the current table, 
and adds and deletes entries in the table. Bad tracks listed in the table 
are “aliased’ ’ to good tracks, such that when a process tries to read or 
write a track listed in the bad track table, one of a replacement tracks 
is used instead. These replacement tracks are allocated when badtrk 
is run during installation. Changing the number of replacement tracks 
allocated may require re-installation of the operating system, so the 
number of replacement tracks allocated should be fairly large. 

To use badtrk , you must be in single user mode. (See 
shutdown (ADM)). 

Options 


-f device 

Opens the partition device and reads the bad track table associated 
with that partition, device must be the active UNIX partition of a 
fixed disk: /dev/rhdOa for the first drive, /dev/rhdla for the 
second, and so on. The default is /dev/rhdOa. 

-e Used by the installation procedure, the -e flag causes badtrk to 
change the size of the bad track table. 

WARNING: The -e flag should not be invoked by the user. Use of the 
-e may restructure the hard disk, rendering much of the information 
stored on it unusable. 

-m max 

Used only in non-interactive mode in conjunction with -e, -m sets 
the maximum number of bad tracks to max. 

-s arguments 

Invokes badtrk non-interactively, causing it to scan the disk for 
bad tracks and enter any errors found in the bad track table. The 
arguments specify either quick or thorough, and either destructive 
or non-destructive scan: 
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[q]uick 

[t]horough 

[destructive 

[n]on-destructive 

The user should specify either q or t, and either d or n. 


Usage 

When badtrk is executed interactively, the program first displays the 
main menu: 

1. Print Current Bad Track Table 

2. Scan Disk (You can choose Read-Only or Destructive later) 

3. Add Entries to Current Bad Track Table by Cylinder/Head Nuiriber 

4. Add Entries to Current Bad Track Table by Sector Nuiriber 

5. Delete Entries Individually From Current Bad Track Table 

6. Delete All Entries From Bad Track Table 

Enter your choice or 'q' to quit: 

You are prompted for option numbers, and, depending upon the option, 
more information may be queried for later. 

A bad track table (option “1”) might look like this: 


Defective Tracks 



Cylinder 

Head 

Sector Number(s) 

1 . 

190 

3 

12971-12987 


Press <RETURN> to continue. 


Option “2” scans the disk for flaws. If changes have been made to 
your bad track table since you last updated the table on disk (or since 
you entered badtrk ), you will be asked if you want to update the disk 
with the new table before scanning. You should answer “y” to save 
your changes, ‘n’ if you don’t want to save changes made up to this 
point. Next you are prompted to specify the kind of scan you wish to 
perform: either quick or thorough, and either destructive or non¬ 
destructive. Choosing a destructive scan will cause all data in the 
scanned region to be lost. After you respond to these prompts, badtrk 
begins its scan. You can interrupt a scan by typing “q” at any time. 
You are then prompted to continue the scan or return to the main 
menu. 

As the program finds flawed tracks, it displays the location of each bad 
track. An example error message might be: 
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wd: ERROR : on fixed disk ctlr=0 dev^0/47 block=31434 ond=00000020 
status=00005180, sector = 62899, cylinder/head = 483/4 

(You may see this kind of message if there is a read or write error dur¬ 
ing the scanning procedure.) 

When the scan is complete, the main menu reappears. The program 
automatically enters any detected flaws in the bad track table. 

If your disk is furnished with a flaw map, you should enter these flaws 
into the bad track table. Select either option “3” or “4”, depending 
upon the format of the flaw map furnished with your disk. Enter the 
defective tracks, one per line. 

When you are satisfied that badtrk contains a table of the desired 
flaws, quit the badtrk program by entering “q” at the main menu. 

If badtrk was invoked with the -e flag (which should only occur when 
called by hdinit, during the installation procedure), and the disk con¬ 
tains a valid division table, the following message is displayed prior to 
the badtrk menu: 

This device contains a valid division table. Additional 
(non-root) filesystems can be preserved across this reinstallation. 

If you wish to be able to preserve these file systems later, you must 
not change the current limit of the bad track table, which is 
n bad tracks. Do you wish to leave it unchanged? <y/n>: 

If you respond “y”, you will not be prompted later to enter a new 
limit for the size of your bad track table. You can add or delete 
entries, but you will not be allowed to increase the maximum number 
of bad tracks allocated. If you respond “n” and the size of your bad 
track table is changed, your disk division table will be destroyed. 

If you do not have a valid disk table or you selected “n” when 
prompted, you are prompted for the number of replacement tracks to 
allocate. There will be a recommended number of replacement tracks 
to allocate based on the number of known bad tracks plus an 
allowance for tracks that may go bad in the future. You should choose 
to allocate at least the recommended number of replacement tracks. 
Make your choice carefully, because if you want to change this 
amount later, you will have to reinstall. 

Before exiting, badtrk will ask whether you wish to update the device 
with the new bad track table. If you wish to save you changes, answer 
“y”. If you wish to leave the bad track table as it was before running 
badtrk , answer “n”. 

Notes 


This utility can only be used in single-user mode. 
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If a bad spot develops in the boot blocks or system tables at the very 
beginning of the fdisk partition, reinstallation is required. 

Files 

/etc/badtrk 

Value Added 

badtrk is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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brc, bcheckrc _ 

system initialization procedures 

Syntax 


/etc/bcheckrc [ -a ] 
/etc/brc 

Description 


These shell procedures are executed via entries in /etc/inittab by 
init( M) whenever the system is booted (or rebooted). 

First, the bcheckrc procedure checks the status of the root file system. 
IF the root file system is found to be bad, bcheckrc repairs it. When 
invoked with the -a (autoboot) flag, bcheckrc will run without opera¬ 
tor intervention, init calls bcheckrc with the -a flag when the system 
autoboots. 

Then, the brc procedure clears the mounted file system table, 
/etc/mnttab, and puts the entry for the root file system into the mount 
table. 

After these two procedures have executed, init checks for the initde- 
fault value in /etc/inittab. This tells init in which run level to place 
the system. Since initdefault is initially set to 2, the system will be 
placed in the multi-user state via the /etc/rc2 procedure. 

Note that bcheckrc should always be executed before brc. Also, these 
shell procedures may be used for several run-level states. 

See Also 


boot(HW), fsck(ADM), init(M), rc2(ADM), shutdown(ADM) 
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captoinfo _ 

convert a termcap description into a terminfo descrip¬ 

tion 

Syntax 

captoinfo [-v ...] [-V] [-1] [-w width] file ... 

Description 


The captoinfo command looks in file for termcap descriptions. For 
each one found, an equivalent terminfo (?) description is written to 
standard output, along with any comments found. A description which 
is expressed as relative to another description (as specified in the 
termcap tc= field) will be reduced to the minimum superset before 
being output. 

If no file is given, then the environment variable TERMCAP is used 
for the file name or entry. If TERMCAP is a full path name to a file, 
only the terminal whose name is specified in the environment variable 
TERM is extracted from that file. If the environment variable 
TERMCAP is not set, then the file /etc/termcap is read. 

-v print out tracing information on standard error as the pro¬ 

gram runs. Specifying additional -v options will cause 
more detailed information to be printed. 

-V print out the version of the program in use on standard 

error and exit. 

-1 cause the fields to print out, one to a line. Otherwise, the 

fields will be printed several to a line, up to a maximum 
width of 60 characters. 

-w change the output to width characters. 

Files 


/usr/lib/terminfo/? /* compiled terminal description data base 

Notes 


Certain termcap defaults are assumed to be true. For example, the bell 
character ( terminfo bel ) is assumed to be "G. The linefeed capability 
(i termcap nl ) is assumed to be the same for both cursor_down and 
scrollJorward (terminfo cudl and ind, respectively.) Padding infor- 


March 15, 1989 


CAPTOINFO-1 












CAPTOINFO (ADM) 


CAPTOINFO (ADM) 


mation is assumed to belong at the end of the string. 

The algorithm used to expand parameterized information for termcap 
fields such as cursorjposition (termcap cm, terminfo cup) will some¬ 
times produce a string which, though technically correct, may not be 
optimal. In particular, the rarely used termcap operation %n will pro¬ 
duce strings that are especially long. Most occurrences of these non- 
optimal strings will be flagged with a warning message and may need 
to be recoded by hand. 

The short two-letter name at the beginning of the list of names in a 
termcap entry, present for backwards compatibility, has been 
removed. 

Diagnostics 


tgetent failed with return code n (reason). 

The termcap entry is not valid. In particular, check for 
an invalid ’tc=’ entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not Boolean, numeric, or string. 

wrong type given for the Boolean (numeric, string) termcap code cc. 

The Boolean termcap entry cc was entered as a numeric 
or string capability. 

the Boolean (numeric, string) termcap code cc is not a valid name. 

An unknown termcap code was specified. 

tgetent failed on TERM=term. 

The terminal type specified could not be found in the 
termcap file. 

TERM=term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 
correct way to cancel an entry is with an ’@\ as in 
’:bs@:\ Giving a null string could cause incorrect 
assumptions to be made by the software which uses 
termcap or terminfo . 

a function key for cc was specified, but it already has the value vv. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the 
key cc already had a value assigned to it. 

the unknown termcap name cc was specified in the ko termcap capability. 

A key was specified in the ko capability which could not 
be handled. 
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the vi character v (info ii) has the value xx, but ma gives n. 

The ma capability specified a function key with a value 
different from that specified in another setting of the 
same key. 

the unknown vi key v was specified in the ma termcap capability. 

A vi (C) key unknown to captoinfo was specified in the 
ma capability. 

Warning: termcap sg (nn) and termcap ug (nn) had different values. 

terminfo assumes that the sg (now xmc) and ug values 
were the same. 

Warning: the string produced for ii may be inefficient. 

The parameterized string being created should be rewrit¬ 
ten by hand. 

Null termname given. 

The terminal type was null. This is given if the environ¬ 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 

See Also 


infocmp(ADM), tic(C), curses (S), terminfo(F) 
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checkaddr 

MMDF address verification program 

Syntax 

/usr/mmdf/bin/checkaddr [-w] [ addresses... ] 

Description 


The checkaddr program is used to check the validity of an address 
within the local mail system (MMDF). checkaddr can be given 
addresses either on the command line, one address per argument, or a 
list of addresses can be given to checkaddr on the standard input, one 
address per line. The latter mode is use for checking the addresses in 
a mailing list by saying “ checkaddr < mailing-list-file checkaddr 
announces each address on a separate line and follows the address 
with its status (normally “OK”), checkaddr uses submit(ADM) to do 
the address verification. 

If the -w option is given, checkaddr causes submit to generate a 
detailed submission tracing. This can sometimes be useful to help 
find problems in alias files or mailing lists. 

See Also 


submit(ADM) 
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checkque 

MMDF queue status report generator 

Syntax 

/usr/mmdf/bin/checkque [-fpsz] [-tage[m]] [-c channel channel...] 

Description 


checkque reports on the amount of mail waiting in the MMDF distri¬ 
bution queue. It indicates the total number of messages and the size of 
the queue directory. It then lists the number of messages waiting for 
each transmission channel. 

The -c option allows one or more channel names to be specified. If 
present, checkque restricts its report to the named channels. 

The -f option causes checkque to print the name of the oldest queued 
message for each channel, -p causes only channels with “prob¬ 
lems” to be listed. Problems are defined as channels which have mail 
waiting for over some “problem threshold.” The default “problem 
threshold” is 24 hours. Tlie -t option is used to change the “problem 
threshold.” A number of hours (or minutes, if “m” is appended) 
should appear without a space after the -t. -s forces an abbreviated 
summary listing instead of the normal multi-line report, -z causes 
channels with no messages queued to be skipped in the report. 

Since the mail queue usually is protected from access by any uid, 
except MMDF, checkque should be run under root or MMDF uid. It 
should not be made setuidQ to mmdf unless you want to allow non¬ 
staff members to see the queue status. 

Most configurations will have only two channels. One is for local 
delivery and the second is for off-machine relaying, such as by calling 
out or by being called up, or by attaching to ArpaNet hosts. Local 
delivery usually happens at the time of submission, so it is rare that 
any mail is waiting in it. Mail in other outbound queues is processed 
by deliver according to your site parameters, either by running deliver 
as a background daemon or by periodically firing it up via cron . 

Files 


quedfldir[]/addr 
quedfldir[]/msg 
quedfldir[]/q.* 
phase-directory/channel!* 
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See Also 


CHECKQUE(ADM) 


deliver(ADM) 

Author 


Dave Crocker, Dept, of E.E., Univ. of Delaware 
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checkup 


Report on MMDF problems 

Syntax 

/usr/mmdf/bin/checkup [-p -\[digit]] 

Description 

The checkup command is used to check aspects of the MMDF system 
configuration. Normally, checkup reports on all problems that are 
encountered, including correct states. Displayed problems are pre¬ 
fixed by two asterisks (**); information that is advisory is enclosed in 
square brackets ([]). 

The two optional flags to checkup specify how much information is 
displayed. The -p option reports only problems detected by checkup. 
This is useful for day-to-day checking of the system, such as mailing 
the output to the postmaster alias. 

The -v flag takes an optional digit which ranges from 1 (the same as 
the -p) option, to level 7 which displays all information. 

Some of the displayed information, such as that about permissions 
modes, varies by site conventions and may not have widespread signi¬ 
ficance. In particular it is common for sites to allow group read, write, 
or execute on files that checkup expects to be protected more care¬ 
fully. Use of group permissions can greatly ease administration 
efforts for system managers without compromising security. Warn¬ 
ings regarding “others” permissions should be examined. 
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chg_audit _ 

enables and disable auditing for the next session 

Syntax 

/tcb/lib/chg_audit [on] 

Description 

chg_audit enables and disable auditing for the next session (next 
reboot). It edits the /etc/inittab and /etc/conf/cf.d/init.base file to add 
or remove the audit startup command when the system is rebooted. 
The command is normally invoked by the auditsh( ADM). 

If on is specified, then auditing is enabled. If no argument is given, 
then the audit lines are removed from the inittab files. 

Files 

/etc/inittab 

/etc/conf/cf.d/init.base 

See Also 

auditsh(ADM), sysadmsh(ADM) 

Value Added 


chg_audit is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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chroot _ 

changes root directory for command 

Syntax 


chroot newroot command 

Description 

The given command is executed relative to the new root. The mean¬ 
ing of any initial slashes (/) in pathnames is changed for a command 
and any of its children to newroot. Furthermore, the initial working 
directory is newroot. 

Notice that: 

chroot newroot command >x 

creates the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root pathname is always relative to the current root even if a 
chroot is currently in effect. The newroot argument is relative to the 
current root of the running process. Note that it is not possible to 
change directories to what was formerly the parent of the new root 
directory; i.e., the chroot command supports the new root as an abso¬ 
lute root for the duration of the command. This means that is 
always equivalent to 

See Also 


chdir(S) 

Notes 


Exercise extreme caution when referencing special files in the new 
root file system. 

command must be under newroot or command is reported: 
command : not found 
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Standards Conformance 


CHROOT (ADM) 


chroot is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cleanque _ 

send warnings and return expired mail 

Syntax 


cleanque [ -w ] 

Description 

cleanque removes extraneous files from the tmp and msg subdirec¬ 
tories of the MMDF “home queue” directory. It also sends warnings 
for mail which has not been fully delivered after “wamtime” hours 
following submission. Finally, it returns mail which has not been fully 
delivered after “failtime” hours after submission. “Wamtime” and 
“failtime” are defined in the MMDF mmdftailor( F) file. 

Generally, cleanque should be run by cron, once a day, but may be run 
at any time to free up space. 

The optional argument, -w, can be used if you are running cleanque 
manually and want to see what the program is doing. 

See Also 


queue(F), deliver(ADM) 

Notes 


cleanque does not currently remove extraneous files from the individ¬ 
ual queues (q.* subdirectories). 
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cleantmp _ 

remove temporary files in directories specified 

Syntax 


/usr/lib/cleantmp 

Description 


cleantmp removes temporary files in directories specified in 
/etc/default/cleantmp under the variable TMPDIRS. By default, /tmp 
and /usr/tmp are examined. Users can add to the list of directories, 
separating each directory with a space. Files in these directories 
which are not accessed within the last n days will be removed, where 
n is the number of days specified under the variable FILEAGING in 
/etc/default/cleantmp. By default, FILEAGING is 7. Users can 
change the number of days for FILEAGING, /usr/lib/cleantmp is run 
as a cron job every day at 3:00a.m. Refer to 
/usr/spool/cron/crontabs/root on the system. The super user can edit 
this file to change the frequency and time at which /usr/lib/cleantmp 
is run. If the directories specified do not exist or if they are mount 
points and the file system are not mounted, cleantmp will send mail to 
root saying that the directory does not exist. 

The format of /etc/default/cleantmp is as follows: 

FELEAGING=7 

TMPDIRS=/tmp /usr/tmp 

Files 


/etc/default/cleantmp 

See Also 

rc2(ADM) 

Value Added 

cleantmp is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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clri_ 

clears inode 

Syntax 

/etc/clri filesystem i-number... 

Description 


clri writes zeros on the 64 bytes occupied by the inode numbered i- 
number. Filesystem must be a special filename referring to a device 
containing a file system. After clri is executed, any blocks in the 
affected file will show up as “missing” if the file system is checked 
with fsck (ADM). Use clri only in emergencies and exercise extreme 
care. 

Read and write permission is required on the specified filesystem de¬ 
vice. The inode becomes allocatable. 

The primary purpose of this routine is to remove a file which, for some 
reason, does not appear in a directory. If you use clri to destroy an 
inode which does appear in a directory, track down the entry and 
remove it. Otherwise, when the inode is reallocated to some new file, 
the old entry will still point to this file. At that point removing the old 
entry will destroy the new file. The new entry will again point to an 
unallocated inode, so the whole cycle is likely to be repeated again 
and again. 

See Also 


fsck(ADM), ncheck(ADM) 

Notes 

If the file is open, clri is likely to be ineffective. 
This utility does not work on DOS filesystems. 
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configure 

kernel configuration program 

Syntax 

/etc/conf/cf.d/configure [ options ] [ resource=value ... ] 

Description 


The configure program determines and alters different kernel 
resources. For end users, using configure is easier than modifying the 
system configuration files directly. For device driver writers, 
configure avoids the difficulties of editing configuration files that 
have already been edited by an earlier driver configuration script. 

You must move to the /etc/conf/cf.d to execute configure. 

Resources are modified interactively or with command-line argu¬ 
ments. Adding or deleting device driver components requires the 
command-line options. 

The next paragraphs discuss how to use configure interactively. 
Command-line options are discussed in the “Options” section. 

Before using configure , to modify the system configuration files, use 
the following command to make a backup copy of the kernel. 

cp /unix /unix.old 

Interactive Usage 

configure functions interactively when no options (including 
resource=value) are given or when -f is the only option specified on 
the command line. 
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When you invoke configure interactively, you first see a category 
menu that looks something like this: 


1. Disk and Buffers 

2. Character Buffers 

3. Files, Inodes, and Filesystems 

4. Processes, Memory Management and Swapping 

5. Clock 

6. Multiscreens 

7. Message Queues 

8. Semaphores 

9. Shared Data 

10. System Name 

11. Streams Data 

12. Event Queues and Devices 

13. Hardware Dependent Parameters 

14. Remote File sharing Parameters 
Select a parameter category to reconfigure 

by typing a number from 1 to 14, or type 'q' to quit: 


To choose a category, enter its number (e.g., “1” for “Disk Buffers”), 
then press (Return). 

Each category contains a number of configurable resources. Each 
resource is presented by displaying its true name, a short description, 
and its current value. For example, for the “Disk Buffers” category 
you might see: 

NBUF: total disk buffers. 

Currently determined at system start up: 

NSABUF: system-addressable (near) disk buffers. 
Currently 10: 

NHBUF: hash buffers (for disk block sorting). 

Currently 128: 

To keep the current value, simply press (Return). Otherwise, enter an 
appropriate value for the resource, then press (Return), configure 
checks each value to make sure that it is within an appropriate range. 
If not, configure warns you that the value is inappropriate and will ask 
you to confirm that you want to override the recommended value. 

To exit from configure , enter q at the category menu prompt. If any 
changes are made, configure asks if it should update the configuration 
files with the changes. To keep the old configuration values, enter n 
at this prompt, and no changes are made. Otherwise, enter y and con¬ 
figure updates the required system configuration files. After 
configure has completed, the kernel is ready for linking. 
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To link the kernel, enter: 

/etc/conf/cf.d/link_unix 

Linking may take a few minutes. After the kernel is linked, enter the 
following command to reboot the system to run the new kernel: 

/etc/shutdown 

Next, you see the boot prompt: 

Boot 

Press (Return). The system is now running the new kernel. 

Options 


The command line options are designed for writers of driver-installa¬ 
tion shell scripts. You can configure drivers, remove driver definitions 
from the configuration files, and modify some driver attributes, all 
from the command line. There are also options for querying the 
current driver configuration. 

configure uses the following options: 


-a [ fund fund ... ] 

-b 

-c 

-d [fund fund ... ] 

-f master Jile [ dfile ] 

-g devjiame handler I devjiame 
-h devjiame 

-j [prefix] [NEXTMAJOR] 

-1 priority lev el 

-m majorjdevjiumber 

-o 

-s 

-t 

-v interrupt vector [ interrupt_vector2...] 

-w 

-x 

-y resource 

-A address address 

-C channel 

-D 

-G 

-H 

-I address address 
-J address address 
-M maximum minimum 
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-O 

-P 

-R 

-S 

-T interrupt scheme 
-U number_of_subdevices 
-V interrupt_yector 
-Y 
-Z 


-m, -b, and -c 

These options are used to define which driver is being referenced. 
Following -m must be the major device number of the driver. If 
you are configuring a block driver, -b must appear; if you are con¬ 
figuring a character driver, -c must appear. Both are used when 
configuring a driver with both kinds of interfaces. 

-s When adding or deleting a streams module, use this option with the 
-h option and instead of -m, -b, and -c. For a streams driver, use it 
with -m and -c. 

-a and -d 

Each option is followed by a list of functions to add or delete, 
respectively. These are the names of the functions that appear 
within bdevsw[] or cdevsw[], as appropriate, plus the names of 
the initialization, clock poll, halt, and interrupt routines, if present, 
plus the name of the tty structure pointer, configure enforces the 
rules that all of a driver’s routines must have a common prefix, and 
that the prefix be 2-4 characters long. 

-h This option is used to give the driver or streams module name 
when the name is different from the prefix or when no prefix is 
specified as in the case of the streams module. The name can be 
1-8 characters long. 

-j When followed by a prefix used by a driver, the major device num¬ 
ber is displayed. When followed by NEXTMAJOR, the smallest 
major device number is displayed. 

-v This option modifies the system notion of the vectors on which this 
device can interrupt. 

-1 This sets the interrupt priority level of the device, which is almost 
always the same as the type of spl{ ) call used: a driver that inter¬ 
locks using spl5{ ) almost always has an interrupt priority level of 
5. Use of this option in new drivers is not recommended. 

-f Much of the configuration data is maintained in two files, whose 
default names are mdevice and mtune. The -f option can be used 
to specify alternate names. Note that if -f is the only option 
present, the program is still interactive. 


September 24,1990 


CONFIGURE-4 



CONFIGURE (ADM) 


CONFIGURE (ADM) 


-w When specifying a parameter value, this option suppresses warning 
messages. 

-o This is the override flag. When invoked non-interactively, this 
option overrides the minimum and maximum values that are other¬ 
wise enforced. No warnings are given. This option has no effect 
on interactive commands. 

-x This dumps all the resource prompts known to configure . These 
reveal the name, description, and current value of each parameter 
capable of being reconfigured. Category prompts are not dumped. 

-y The -y option displays the current value of the requested parame¬ 
ter. 

-t This option displays nothing (except possibly error messages). 
However, it has a return value of 1 if a driver corresponding to the 
given combination of -m, -b, -c and options is already configured, 
and returns 0 if no such driver is present. 

-g This option is used to add or remove graphics input (GIN) device 
handlers. Devices such as mice, bitpads, and keyboards may have 
handlers to turn their input data into “events.” The -g flag may be 
given one argument that is interpreted as a device name. That GIN 
device is removed from the configuration files. If the -g flag has 
two arguments, the second is a handler for that device, and the de¬ 
vice is added to the files. If it was already present, its handler is 
updated and the user is informed. Multiple devices may be added 
or removed by specifying -g multiple times. 

-A This option, followed by two values that are taken to be hexade¬ 
cimal I/O addresses, returns the name of the device with the I/O 
address conflict. 

-C Followed by an integer, this option used with -a indicates the DMA 
channel that the device uses. The default is not to use DMA. 

-D This option used with the -a option adds to the device driver the 
characteristic that the driver can share its DMA channel; -D used 
with the -d option deletes this characteristic. The default is not to 
share. 

-G This option with -a adds the G characteristic to the driver; -G with 
-d deletes the G characteristic. This characteristic indicates 
whether or not the device uses an interrupt, even though an inter¬ 
rupt is specified in the sdevice entry. This is used when you want 
to associate a device to a specific device group. The default is not 
to set this characteristic. 
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-H This option with -a or -d adds or deletes the characteristic that the 
driver supports hardware that distinguishes it from those that are 
entirely software (pseudo devices). The default is to set this 
characteristic. 

-I This option is followed by two values that are the hexadecimal 
start and end I/O addresses. The default values are zero. 

-J The option is followed by two values that are the hexadecimal start 
and end controller memory addresses. The default values are zero. 

-MThis option followed by two integers states the maximum and min¬ 
imum number of devices that can be specified in the sdevice file. 
The default is a maximum of 1 and a minimum of 0. 

-O This option with -a or -d indicates whether or not the IOA range of 
the device can overlap that of another device. The default is no. 

-P When used with -a or -d, adds or deletes an ignore “I” flag in the 
device mdevice entry. The “I” flag allows the configuration build 
utilities to ignore a devices pack.d directory (useful to the mpt/spt) 
driver. 

-R This option with -a or-d indicates whether or not the driver is 
required in the kernel all the time. The default is yes. 

-S This option with -a or -d indicates whether or not the driver has 
one sdevice entry only. The default is no. 

-T This option, when followed by an argument, states the type of 
interrupt scheme the device uses. The possible arguments are: 

0 The device does not require an interrupt line. 

1 The device requires an interrupt line. If the de¬ 
vice supports more than one controller, each 
controller requires a separate interrupt. 

2 The device requires an interrupt line. If the de¬ 
vice supports more than one controller, the con¬ 
trollers share the same interrupt. 

3 The device requires an interrupt line. If the de¬ 
vice supports more than one controller, the con¬ 
trollers share the same interrupt. Multiple de¬ 
vice drivers having the same interrupt priority 
level can share this interrupt. 

The default is 0. 


September 24,1990 


CONFIGURE-6 



CONFIGURE (ADM) 


CONFIGURE (ADM) 


-U This option, when followed by an integer, encodes a device¬ 
dependent numeric value in the sdevice file to indicate the number 
of subdevices on a controller or a pseudo device. The integer must 
be a value that lies within the maximum and minimum number of 
devices specified in the mdevice file. The default is 1. 

-V This option, followed by a vector value, returns the name of the de¬ 
vice with the vector conflict. 

-Y This option with -a or-d indicates whether or not to configure a 
driver into the kernel. Specifying -a puts a “Y” in the configura¬ 
tion field of the driver’s sdevice entry; specifying -d puts an “N” 
in this field. The default is to put a “ Y”. 

-Z This option indicates that a device can have more than one entry in 
the mdevice file. The SCSI driver is an example of a driver that 
needs this feature. The option is usually used when adding a new 
entry or deleting a particular entry in the mdevice file. Using -d 
with -Z removes only the mdevice entry. Using -d without -Z 
removes the mdevice entry and the sdevice entry. 

Setting Command-Line Parameters 

Any number of arguments can be given on the command line of the 
form resource=value. These arguments can be given at the same time 
as an add or delete driver request, but must follow all the driver-con¬ 
figuration arguments on the command line. 

If one or more instances of resource=value are the only arguments on 
the command line, the changes are made non-interactively. If the 
values given are outside the permissible range for a parameter, no 
action is taken unless the -o option is included to override them. 

Some resources have values that are character strings. In this case, 
their values must be enclosed within the characters V’. The quotes are 
syntactically necessary for them to be used as C-language strings, and 
the backslashes protect the quotes from being removed by the shell. 

Examples 


Print out the current value of NCLIST: 
configure -y NCLIST 

Return 1 if character major device 7 and vector 3 are already config¬ 
ured: 

configure -t -v 3 -m 7 -c 
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Add a clock-time polling and initialization routine to the already con¬ 
figured “foo” driver, a hypothetical character driver at major device 
#17: 

configure -a foopoll fooinit -c -m 17 
Delete the “foo” driver: 
configure -m 17 -d -c 

Add a new “hypo” driver, a block driver with a character interface. It 
absorbs 3 different interrupt vectors, at priority 6: 

configure -a hypoopen hypoclose hyporead hypowrite hypoioctl \ 
hypostrategy hypoprint hypointr -b -c -16 -v 17 42 49 -m 10 

Add a new streams module with prefix “grb” and name “garble”: 

configure -s -a grbinit -h garble 

Files 


/etc/conf/cf.d/mdevice 

/etc/conf/cf.d/sdevice 

/etc/conf/cf.d/mtune 

/etc/conf/cf.d/stune 

/etc/conf/cf.d/mevent 

/etc/conf/cf.d/sevent 

See Also 


idconfig(ADM), link_unix(ADM), majorsinuse(ADM), 
routines(ADM), vectorsinuse(ADM), mdevice(F)> mtune(F), 
sdevice(F), stune(F), event(M), “Timing System Performance” in the 
System Administrator’s Guide 

Value Added 


configure is an extension of AT&T System V provided by The Santa 
Cruz Operation, Inc. 
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consoleprint _ 

print /usr/adm/messages or any file to a serial printer 

attached to the printer port of a serial console 

Syntax 

consoleprint [ file ] 

Description 

consoleprint prints the file /usr/adm/messages to a printer attached to 
the printer port of a serial console. If a filename is specified, it is 
printed instead, consoleprint is normally run by a system administra¬ 
tor to get a hardcopy version of the system console messages. 

This command uses the file /etc/termcap. 

Files 


/etc/termcap 

See Also 

lprint(C) 

Notes 


The only terminals currently supported with entries in /etc/termcap are 
the Tandy DT-100 and DT-1, and the Hewlett-Packard HP-92. 

Terminal communications parameters (such as baud rate and parity) 
must be set up on the terminal by the user. 

Value Added 


consoleprint is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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crash____ 

examine system images 

Syntax 

/etc/crash [ -d dumpfile ] [ -n namelist ] [ -w outputfile ] 

Description ___ 

The crash command is used to examine the system memory image of a 
live or a crashed system by formatting and printing control structures, 
tables, and other information. Command line arguments to crash are 
dumpfile, namelist, and outputfile. 

Dumpfile is the file containing the system memory image. The default 
dumpfile is /dev/mem. 

The text file namelist contains the symbol table information needed 
for symbolic access to the system memory image to be examined. The 
default namelist is /unix. If a system image from another machine is 
to be examined, the corresponding text file must be copied from that 
machine. 

When the crash command is invoked, a session is initiated. The output 
from a crash session is directed to outputfile. The default outputfile is 
the standard output. 

Input during a crash session is of the form: 
function [argument... ] 

where function is one of the crash functions described in the Functions 
section of this manual page, and arguments are qualifying data that 
indicate which items of the system image are to be printed. 

The default for process-related items is the current process for a run¬ 
ning system and the process that was running at the time of the crash 
for a crashed system. If the contents of a table are being dumped, the 
default is all active table entries. 

The following function options are available to crash functions wher¬ 
ever they are semantically valid. 

-e Display every entry in a table. 

-f Display the full structure. 
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-p Interpret all address arguments in the command line as physical 
addresses. 

-s process 

Specify a process slot other than the default. 

-w file 

Redirect the output of a function to file. 

Note that if the -p option is used, all address and symbol arguments 
explicitly entered on the command line will be interpreted as physical 
addresses. If they are not physical addresses, results will be incon¬ 
sistent. 

The functions mode , defproc , and redirect correspond to the function 
options -p, -s, and -w. The mode function may be used to set the 
address translation mode to physical or virtual for all subsequently 
entered functions; defproc sets die value of the process slot argument 
for subsequent functions; and redirect redirects all subsequent output. 

Output from crash functions may be piped to another program in the 
following way: 

function [argument... ]! shell_command 
For example, 

mount! grep rw 

will write all mount table entries with an rw flag to the standard out¬ 
put. The redirection option (-w) cannot be used with this feature. 

Depending on the context of the function, numeric arguments will be 
assumed to be in a specific radix. Counts are assumed to be decimal. 
Addresses are always hexadecimal. Table slot arguments are always 
decimal. Table slot arguments larger than the size of the function table 
will not be interpreted correctly. Use the findslot command to translate 
from an address to a table slot number. Default bases on all arguments 
may be overridden. The C conventions for designating the bases of 
numbers are recognized. A number that is usually interpreted as 
decimal will be interpreted as hexadecimal if it is preceded by Ox and 
as octal if it is preceded by 0. Decimal override is designated by Od, 
and binary by Ob. 

Aliases for functions may be any uniquely identifiable initial substring 
of the function name. Traditional aliases of one letter, such as p for 
proc, remain valid. 

Many functions accept different forms of entry for the same argument. 
Requests for table information will accept a table entry number or a 
range. A range of slot numbers may be specified in the form a-b where 
a and b are decimal numbers. An expression consists of two operands 
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and an operator. An operand may be an address, a symbol, or a num¬ 
ber; the operator may be +, -, *, /, &, or I. An operand which is a num¬ 
ber should be preceded by a radix prefix if it is not a decimal number 
(0 for octal, Ox for hexadecimal, Ob for binary). The expression must 
be enclosed in parentheses (). Other functions will accept any of 
these argument forms that are meaningful. 

Two abbreviated arguments to crash functions are used throughout. 
Both accept data entered in several forms. They may be expanded 
into the following: 

table_entry = table entryl range 

start_addr = addressl symboll expression 


Functions 


? [ -w file ] 

List available functions. 

!cmd 

Escape to the shell to execute a command. 

adv [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Print the advertised table. 

base [ -w file ] number ... 

Print number in binary, octal, decimal, and hexadecimal. A number 
in a radix other than decimal should be preceded by a prefix that 
indicates its radix as follows: Ox, hexadecimal; 0, octal; and Ob, 
binary. 

buffer [ -w file] [ -format ] bufferslot 
or 

buffer [ -w file] [ -format ] [ -p ] start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. The follow¬ 
ing format designations are recognized: -b, byte: -c, character; -d, 
decimal; -x, hexadecimal; -o, octal; -r, directory; and -i, inode. If 
no format is given, the previous format is used. The default format 
at the beginning of a crash session is hexadecimal. 

bufhdr [ -f ] [ -w file ] [ [-p ] table_entry ... ] 

Alias: buf. 

Print system buffer headers. 
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callout [ -w file ] 

Alias: c. 

Print the callout table, 
dballoc [-wfile] [class ... ] 

Print the dballoc table. If a class is entered, only data block alloca¬ 
tion information for that class will be printed. 

dbfree [-wfile] [class...] 

Print free streams data block headers. If a class is entered, only 
data block headers for the class specified will be printed. 

dblock [ -e ] [ -w file ] [ -c class... ] 

or 

dblock [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Print allocated streams data block headers. If the class option (-c) 
is used, only data block headers for the class specified will be 
printed. 

defproc [ -w file ] [ -c ] 
or 

defproc [ -w file ] [ slot ] 

Set the value of the process slot argument. The process slot argu¬ 
ment may be set to the current slot number (-c) or the slot number 
may be specified. If no argument is entered, the value of the previ¬ 
ously set slot number is printed. At the start of a crash session, the 
process slot is set to the current process. 

dis [ -w file ] [ -a ] start_addr [ count ] 

Disassemble from the start address for count instructions. The 
default count is 1. The absolute option (-a) specifies a non- 
symbolic disassembly. 

ds [ -w file ] virtual_address ... 

Print the data symbol whose address is closest to, but not greater 
than, the address entered. 

file [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Alias: f. 

Print the file table, 
findaddr [ -w file ] table slot 

Print the address of slot in table. Only tables available to the size 
function are available to findaddr. 

findslot [ -w file ] virtual_address ... 

Print the table, entry slot number, and offset for the address 
entered. Only tables available to the size function are available to 
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findslot. 

fs[-wfile] [ [-p ] table_entry ...] 

Print the file system information table. 

gdp [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry ... ] 

Print the gift descriptor protocol table. 

gdt [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Print the global descriptor table. 

help [ -w file ] function ... 

Print a description of the named function, including syntax and 
aliases. 

idt [ -e ] [ -w file ] [ [-p ] table_entry ...] 

Print the interrupt descriptor table. 

inode [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry ... ] 

Alias: i. 

Print the inode table, including file system switch information. 
kfp[-wfile] [value] 

Print the frame pointer for the start of a kernel stack trace. If the 
value argument is supplied, the kfp is set to that value. 

lck [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Alias: 1. 

Print record-locking information. If the -e option is used or table 
address arguments are given, the record lock list is printed. If no 
argument is entered, information on locks relative to inodes is 
printed. 

Idt [-e] [-wfile] [-sprocess] [[-p] table_entry ...] 

Print the local descriptor table for the given process, or for the 
current process if none is given. 

linkblk [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Print the linkblk table. 

map [ -w file ] mapname ... 

Print the map structure of mapname. 

mbfree [ -w file ] 

Print free streams message block headers. 

mblock [ -e ] [ -w filename ] [ [ -p ] table_entry ... ] 

Print allocated streams message block headers. 

mode [ -w file ] [ mode ] 

Set address translation of arguments to virtual (v) or physical (p) 
mode. If no mode argument is given, the current mode is printed. 
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At the start of a crash session, the mode is virtual. 

mount [ -e ] [ -w file ] [ [ -p ] table_entry ... ] 

Alias: m. 

Print the mount table. 

nm [ -w file ] symbol... 

Print value and type for the given symbol. 

od [-p] [-wfile ] [-format] [-mode] [-sprocess] start addr [count] 
Alias: rd. “ 

Print count values starting at the start address in one of the follow- 
“8 f omate: character (-c), decimal (-d), hexadecimal (-x), octal 
(-o), ASCII (-a), or hexadecimal/character (-h), and one of the fol¬ 
lowing modes: long (-1), short (-t), or byte (-b). The default mode 
for character and ASCII formats is byte; the default mode for 
decimal, hexadecimal, and octal formats is long. The format -h 
prints both hexadecimal and character representations of the 
addresses dumped; no mode needs to be specified. When format or 
mode is omitted, the previous value is used. At the start of a crash 
session, the format is hexadecimal and the mode is long. If no 
count is entered, 1 is assumed. 

panic 

Print the latest system notices, warnings, and panic messages from 
the limited circular buffer kept in memory. 

pcb [ -w file ] [ process ] 

Print the process control block (TSS) for the given process If no 
arguments are given, the active TSS for the current process is 
printed. r 

pdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 

The page descriptor table of the designated memory section and 
segment is printed. Alternatively, the page descriptor table start¬ 
ing at the start address for count entries is printed. If no count is 
entered, 1 is assumed. 

pfdat [ -e ] [ -w file ] [ [-p ] table_entry ...] 

Print the pfdata table. 

proc[-e][-f] [ -w file ] [ [-p ] table_entry ... #procid...] 
or 

proc [-f] [-wfile] [-r] 

Alias: p. 

Print the process table. Process table information may be specified 
in two ways. First, any mixture of table entries and process ids 
may be entered. Each process id must be preceded by a #. Alterna¬ 
tively, process table information for executable processes may be 
specified with the executable option (-r). The full option (-1) 
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details most of the information in the process table as well as the 
region table for that process. 

qrun [ -w file ] 

Print the list of scheduled streams queues. 

queue [-e] [-wfile] [ [-p ] table_entry ... ] 

Print streams queues. 

quit 

Alias: q. 

Terminate the crash session. 

rcvd [-e] [-f] [-wfile] [[-p]table_entry ...] 

Print die receive descriptor table. 

redirect [ -w file ] [ -c ] 


or 

redirect [-wfile] [file] , „ 

Used with a file name, redirects output of a crash session to the 
named file. If no argument is given, the file name to which output 
is being redirected is printed. Alternatively, the close option (-c) 
closes the previously set file and redirects output to the standard 
output. 

region [-e] [-wfile] [[-p]table_entry ...] 

Print the region table. 

sdt [ -e ] [ -w file ] [ -s process ] section 
or 

sdt [-e] [-wfile] [-sprocess] [-p] start_addr [count] 

The segment descriptor table for the current process is printed. 

search [-p] [-wfile] [-mmask] [-sprocess] pattern start_addr count 
Print the long words in memory that match pattern, beginning at 
the start address for count long words. The mask is anded (&) with 
each memory word and the result compared against the pattern. 
The mask defaults to Oxffiffiff. 

size [-wfile] [-x] [structure_name ... ] 

Print the size of the designated structure. The (-x) option prints the 
size in hexadecimal. If no argument is given, a list of the structure 
names for which sizes are available is printed. 

sndd [-e] [-f] [-wfile] [[-p]table_entry ...] 

Print the send descriptor table. 
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srmount [ -e ] [-wfile] [ [ -p ] table_entry ... ] 

Print the server mount table. 

stack [ -w file ] [ process ] 

Alias: s. 

Dump stack. If no arguments are entered, the kernel stack for the 
current process is printed. The interrupt stack and the stack for the 
current process are not available on a running system. 

stat [ -w file ] 

Print system statistics. 

stream [-e] [-f] [-wfile] [[-p] table_entry ... ] 

Print the streams table. 

strstat [ -w file ] 

Print streams statistics. 

trace [-wfile] [-r] [process] 

Alias: t. 

Print kernel stack trace. The kfp value is used with the -r option. 

ts [-w file ] virtual_address ... 

Print closest text symbol to the designated address. 

[ ■* J [ [ *w file ] [ -t type [ [ -p ] table_entry ... ] ] 

Valid types: co, cl, c2 (console, coml, com2). 

Print the tty table. If no arguments are given, the tty table for the 
console is printed. If the -t option is used, the table for the single 
tty type specified is printed. If no argument follows the type 
option, all entries in the table are printed. A single tty entry may 
be specified from the start address. 

user [ -f ] [ -w file ] [ process ] 

Alias: u. 

Print the ublock for the designated process. 

var [ -w file ] 

Alias: v. 

Print the tunable system parameters. 

vtop [ -w file ] [ -s process ] start_addr... 

Print the physical address translation of the virtual start address. 

Files 


/dev/mem system image of currently running system 
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custom __ 

installs specific portions of the UNIX System 

Syntax 

custom [-od] [-irla [package] ] [-m device] [-f [file] ] 


Description 

With custom you can create a custom installation by selectively instal¬ 
ling or deleting portions of the UNIX system, custom is executable 
only by the super-user and is either interactive or can be invoked from 
the command line with several options. 

Files are extracted or deleted in packages. A package is a collection 
of individual files. 

You can also install additional sets. You can list the available pack¬ 
ages by using the custom command as described next. 

Usage 


To use custom interactively, enter: 
custom 

The custom main menu appears with the following options: 


Install 

Allows a product or system to be added. 

A window is first opened to select the system set or product. Wb en 
a system or product is selected, you are given the choice of adding 
the “Entire Product”, “Packages” or “Files”. When Entire Pro¬ 
duct” is chosen, custom calculates which installation volumes 
(distribution media) are needed, then prompts for the correct 
volume numbers. 

If “Packages” is chosen, a list of all available packages in the 
currently selected set is displayed. Each line describes the pack¬ 
age name, whether the package is fully installed, not installed or 
partially installed, the size of the package (in 512 byte blocks), and 
a one line description of the package contents. 
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^ U iP tr^ ageS i Can s Pf clfied by marking them with the 
r t"? 6 seected packages will appear with asterisks. 
® xec " ted ’ custom will prompt for insertion of the necessary 
volumes. (You cannot use custom to install the entire RTS pack¬ 
age if that package is already partially installed. If this situation 
omes up, use fixperm(ADM) to determine which files are missing 
and then use custom to install each file individually.) S ’ 


If Files’’ is chosen, you are prompted to select the 
then the file names, custom then prompts for volumes. 


package and 


Remove 

Deletes the correct files in the specified 
the product or package to be deleted just 
package to install. 


package/product. Select 
as you select a product or 


List 

Lists all files in the specified package or all packages in a product 


Quit 

Leaves custom. 


Options _ 

^ uments 816 required for a completely non-interactive use of 

A set identifier 

(-0 or -d) 

A command 
(-i, -r, -1,-f, or -a) 

And either one or more package names, or a file name 

forTe mSJST ^ comn “” d ltoe - “*“> 

Only one of -o, or -d may be specified. These stand for: 

-o Operating System 
-d Development System 
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Only one of -i, -r, -1, -f, or -a may be specified followed by an argu¬ 
ment of the appropriate type (one or more package names, or a file 
name). These options perform the following: 


-i Install the specified package(s) 


-r Remove the specified package(s) 

-1 List the files in the specified package(s). 


-f Install the specified file. 


-a Add a new product 

The -m flag allows the media device to be specified Thedefault is 
/dev/install 8 (which is always the 0 device, as in‘/^v/fdO). Ttas is wry 
useful if the system has a 5.25-inch drive on /dev/fdO and a 3 5-mch 
floppy on /dev/fdl, and it is necessary to install 3.5-inch media, tor 

example: 


custom -m /dev/rfdl96ds9 

this will override the default device and use the one supplied with the 
-m flag. 


Files 

/etc/perms/* 


See Also 

fixperm(ADM), df(C), du(C), xinstall(ADM) 


Notes 


If vou upgrade any part of your system, custom detects if you have a 
different P release and prompts you to insert the floppy volume that 
updates the custom data files. Likewise, if you insert an mvalid pro- 
duct or “volume out of order, you will be prompted to reinsert the 


correct volume. 
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2£!iy SSSS of ±e operating system ’ ^ RTS package is a,wa y s 

Value Added _ 

CruzOf»radon XtenS '° n " AT&T SysBm V develo P ed ^ “* Santa 
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dbmbuild _____ 

builds the MMDF hashed database of alias and routing 

information 

Syntax ___ 

/usr/mmdf/table/dbmbuild [ -nvdk] ] [ database [ table ...] ] 


Description 


dbmbuild reads the tables specified in the MMDF tailor We into a 
hashed database for use in quickly verifying 

assigning channels to submitted messages. Whenever you change 
MMDF alias or routing information in any way, y°“ must .[®^ 
hashed database by logging in as mmdf and running dbmbuild from the 

lusrlmmdfltable directory. 

If no database file is specified, the default database mmdfdbm is 
used. If no table files are specified, all tables listed in the tador fi 
are used. In particular, three tables are read for each channel defrni 
tion- the list of authorized sources, the list of authorized destinations, 
and the table of names/aliases for that channel. Also, the remaining 
tables (MTBL and MDMN) are read. 


The options are: 

n Create a new database. If this option is omitted, dbmbuild updates 
an existing database. If no options at all are specified, -n is 
assumed; however, if you give any options (even -v), you must 
specify the -n option if you want to create a new database. 

v Run in verbose mode, displaying information during table process¬ 
ing. 


d 

k 


Run in debug mode, reporting everything that happens. 

Keep going. If a file is mentioned that does not exist, ignore it. 
This option might be an appropriate default at some sites. 


Appropriate locks are placed on the database so that dbmbuild can 
safely be run while MMDF is in operation. 
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Files 


DBMBUILD (ADM) 


/usr/mmdf/mmdftailor 
/usr/mmdf/table/alias.list 
/usr/mmdf/table/alias.user 
/usr/mmdf/table/*.chn 
/usr/mmdf/table/* .dom 

$(tbldbm).dir 

$(tbldbm).pag 

$(tbldbm).lck 

$(tbldfldir)/* 


database directory 

database pages 

database locking file 

various tables that form the database 


See Also 


tables(F), mmdftailor(F), dbm(S), 
the System Administrator’s Guide 


“Setting Up Electronic Mail” 


in 


March 15,1989 


DBMBUILD-2 










DCOPY(ADM) 


DCOPY(ADM) 


dcopy ___ 

copy UNIX filesystems for optimal access time 

Syntax ___ 

/etc/dcopy [-sX] [-an] [-d] [-v] [-ffsize[:isize] ] inputfs outputfs 


Description 


The dcopy command copies filesystem inputfs to outputfs. Inputfs is 
the device file for the existing file system; outputfs is the device tile 
to hold the reorganized result. This utility is for UNIX fileystems 
onlv For the most effective optimization, inputfs should be the raw 
device and outputfs should be the block device. Both inputfs and out¬ 
putfs should be unmounted file systems. 


With no options, dcopy copies files from inputfs compressing direc¬ 
tories by removing vacant entries, and spacing consecutive blocks m a 
file by the optimal rotational gap. The possible options are: 


supply device information for creating an optimal organi¬ 
zation of blocks in a file. The forms of X are the same as 
the -s option of fsck(ADM). 

place the files not accessed in n days after the free blocks 
of the destination file system (default for n is 7). If no n is 
specified, then no movement occurs. 

leave order of directory entries as is (default is to move 
sub-directories to the beginning of directories). 

currently reports how many files were processed, and how 
big the source and destination freelists are. 


specify the outputfs file system and inode list sizes (in 
blocks). If the option (or usize) is not given, the values 
from the inputfs are used. 

dcopy catches interrupts and quits, and reports on its progress. To ter¬ 
minate dcopy send a quit signal, followed by an interrupt or quit. 


See Also 

fsck(ADM), mkfs(ADM), ps(C) 
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deliver 


MMDF mail delivery process 

Syntax 


Kill i', CCl T’ C n? ] [ - ,mins] « [-mmaxsort] [- 

Llogtile] [-Tsecs] [-Vloglevel] [message 1 ... messageN] 

Description 


TTie program handles the management of all mail delivery 

under the MMDF mail system, deliver does not deliver mail directly^ 
but instead calls on MMDF channels to handle actual delivery’ 
deliver s actions are guided by the MMDF tailoring file 
/usr/mmdf/mmdftailor, and by the command line options. The pro- 
gram can run as either a daemon or a user-invoked program. The pro¬ 
gram may be called to process the entire mail queue or just handle 
some explicitly named messages. When possible, deliver will attempt 
messages in the order received, deliver also maintains a 

whJh f h ° St a P er ' c hannel basis which allows hosts 

which are unavailable for delivery to be skipped until available. 

it?/™ builds a h? 1 ° f chann els to process, either from the com- 
M^vt r or composed of all the non-passive channels in the system. 
Next a list of messages to process is collected, either from the com¬ 
mand line or by scanning the mail queue for for each channel. If the 
he number of messages in the queue for a given channel is more than 

2 * S °u (Set , m t , ai ® r flle or on command line), the queue directory for 
that channel will be processed in the order read, without sorting by 
submission time. If a list of messages is given on the command line^ 
no sorting will take place and the messages will be delivered in the 

2 P e S ^ ing keys < in order ) ; channel, submission 

time, and finally host. This causes many accesses to the messages but 
minimizes the mvocation of channel programs. 

iiiT^ er the / u P eruser to allow it to set its real and effective 

UID and GID to that of the MMDF user. 

The following options may be used to alter deliver' s behavior: 

-b Background mode. Causes deliver to run as a background daemon 
making periodic sweeps over the mail queues looking for 
undelivered mail and attempting deliver. The invoker must be the 

f^n 1 " r e u, Uperuser t0 use this °P tion - deliver attempts 
™ essa 8 es - then sleeps, and then repeats the 
process. The default sleep time is 10 minutes but it can be 
changed (see the -T option below). 
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-cchannel 1 ,channel2,... . 

Channel selection. A comma-separated list of channels to be pro¬ 
cessed. 

-d Already in “quedfldir”. This option will cause deliver to assume 
it is already in the mail queue and therefore it will not issue an ex¬ 
plicit chdir(). This is useful if you wish to have deliver operate on 
an alternate mail queue hierarchy, mainly fortesting. 

Sets the “time-to-live” for entries in the dead-host cache. This 
time defaults to 2 hours. The dead host cache is used to prevent 
attempts to deliver to hosts that are known to be down lhe 
“time-to-live” is given in minutes. If the number of minutes is 
negative, dead host caching is disabled. 

" m Seethe sort threshold. If there are more than maxsort messages in 
a given channel’s queue, then they are processed in directory order 
without first sorting by submission tune. If -m is TvcnoT^’ ^ 
value of maxsort is given in the tailor file by MMAXSOK1. 

-p Pickup only mode. Indicates that the invoker would like to pickup 
a passive mail channel. 

-s Force linear search of the mail queue. Noimally deliver will 
deliver messages in the order they were received which seldom 
matches the order in the directory. This option is useful if the 
queue gets so large that deliver can no longer deal with sorting the 
queue in a reasonable time. 


Time limiting. This option prevents deliver from attempting to 
deliver messages which have been in the queue for more than hrs 
hours For efficiency reasons, this option only applies when the 
queue is being sorted. If an explicit list of messages was given on 
die command line, if the -s option is in effect, or there are more 
messages than the maxsort threshold (see the -m option), then tim 
limiting does not occur. 

-w Watch the delivery. Causes deliver to print informative messages 
on the standard output as it is attempting delivery. This option is 
passed onto the channel programs which also give informative 
messages. 

' U °S g ete le the logfile for this deliver to the file specified. The default is 
to log into die file msg.log in the MMDF log directory. This option 
is only available to the Superuser and MMDF. 


March 15,1989 


DELIVER-2 








DELIVER (ADM) 


DELIVER (ADM) 


-Tseconds 

Sets die sleep time between background sweeps of the mail queue 
This defaults to 10 minutes. 4 

-Vloglevel 

Sets the logging level for this deliver to the level specified. The 
log level should be a valid mmdf logging level string such as FTR. 
this option is only available to the superuser and MMDF. 

See Also 


submit(ADM), queue(F), mmdftailor(F) 

Value Added 


Operation 311 extens ’ on AT&T System V provided by the Santa Cruz 
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dial, uuchat 

dials a modem 


Syntax 

/usr/lib/uucp/dialX ttyname telno speed 
/usr/lib/uucp/dialX -h ttyname speed 
/usr/lib/uucp/uuchat ttyname speed chat-scnpt 

Description 


/usr/lib/uucp/dialX dials a modem attached to ttyname . (X is a dialer 
name, such as HA1200.) The -h option is used to hang up the modem. 


uucico (ADM), ct(C), and cu( C) use /usr/lib/uucp/dialX. p ourdialCT 
programs are distributed. dialHA12 is for the Hayes® Smardnodem 
1200 and 1200B (and compatibles). dialHA24 is for the HayesO 
Smartmodem 2400 (and compatibles). dialVA3450 is for the Racal- 
Vadic VA3450-Series dialers. dialTBIT is for the Telebit Trailblazer. 
Source for these is provided in their respective .c files. 


uucico (ADM) invokes dial, with a ttyname, telno (phone number), 
and speed, dial attempts to dial the phone number on specified 
line at the given speed. When using the dialHA12 or dialHA24 speed 
can be a range of baud rates. The range is specified with the form: 


lowrate - highrate 

where lowrate is the minimum acceptable connection baud rate and 
highrate is the maximum. The dial program returns the status of the 
attempt through the following dial return codes. 


bit 0x80 =1 

The connection attempt failed. 


bits OxOf = 

If bit 0x80 is a 


1, then these bits are the dialer error code: 


0 general or unknown error code. 

1 line is being used. 

2 a signal has aborted the dialer. 
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3 dialer arguments are invalid. 

4 the phone number is invalid. 

5 the baud rate is invalid or the dialer could not 
connect at the requested baud rate. 

6 can’t open the line. 

7 ioctl error on the line. 

8 timeout waiting for connection. 

9 no dialtone was detected. 

10 unused. 

11 unused. 


12 unused. 


13 phone is busy. 

14 no carrier is detected. 

15 remote system did not answer. 


Error codes 12-15 are used to indicate that the problem is at the 
remote end. 


If bit 0x80 is a 0, then these bits are used to indicate the actual con¬ 
nection baud rate. If 0, the baud rate is the same as the baud rate used 
to dial the phone number or the highest baud rate if a range was 
specified. Otherwise, these four bits are the CBAUD bits in the struct 
termio c flag and the struct sgttyb sg ispeed and sg ospeed tty ioctl 
structures. ~ 


You can copy and modify one of the files /usr/Iib/uucp/dialHA12.c 
et F:’ u° u S6 ,j L dlffere ! lt modem - There is a makefile in /usr/lib/uucp 
which should be modified for the new dialer, and can be used to com- 
pile the new program. 


If you create a dial program for another modem, send us the source 
user generated dial programs will be considered for inclusion in 
tuture releases. 


The dm/program to be used on a particular line is specified in the fifth 
field of the entry for that lme in /usr/lib/uucp/Devices. If there is no 
dial program of that name, then uucico, ct, and cu use a built-in dialer, 
together with the chat-script of that name in /usr/lib/uucp/Dialers. 
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dial -h is executed by getty 
between dial-in and dial-out. 

uses /usr/lib/uucp/uuchat, 
/usr/lib/uucp/Dialers. 


when it is respawned on a line shared 
If there is no dial program, then getty 
passing it the & chat-script from 


Files 


/usr/lib/uucp/Devices 
/usr/lib/uucp/dial V A3450 
Aisr/lib/uucp/dialHA12 
/usr/lib/uucp/dialHA24 

/usr/lib/uucp/makefile 

/usr/lib/uucp/dialTBIT 

/usr/lib/uucp/uuchat 


Racal Vadic 3450 dialer 
Hayes Smartmodem 1200/1200B dialer 
Hayes Smartmodem 2400 dialer 
Makefile to compile new dialer 
Telebit Trailblazer dialer 


See Also 


ct(C), cu(C), uucico(ADM), dialers(F), getty (M) 


Notes ____ 

You must have the Development System installed in order to compile 
and install a new dial program. 


Value Added_____ 

dial is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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diskusg _ 

generate disk accounting data by user ID 

Syntax 

diskusg [options] [files] 

Description 


diskusg generates intermediate disk accounting information from data 
+ l f s \ 0T standard mput if omitted, diskusg outputs lines on the 
Sock? ° UtPUt ’ ° ne ^ ^ “ thC folIowin 8 format: uid login 


where 

uid 

login 

ttblocks 


the numerical user ID of the user. 

the login name of the user; and 

the total number of disk blocks allocated to this user. 


diskusg normally reads only the inodes of file systems for disk 
accountmg. In this case, files are the special filenames of these de- 


diskusg recognizes the following options: 

the input data is already in diskusg output format. 
diskusg combines all lines for a single user into a single 
lme. & 

' v verbose. Print a list on standard error of all files that 

are charged to no one. 

-i fnmlist ignore the data on those file systems whose file system 
name is in fnmlist. Fnmlist is a list of file system 
names separated by commas or enclosed within quotes. 
diskusg compares each name in this list with the file 
system name stored in the volume ID [see 
labelit (ADM)]. 

-V file use file as the name of the password file to generate log¬ 

in names, /etc/passwd is used by default. 

-ufile write records to file of files that are charged to no one 

Records consist of the special file name, the inode num¬ 
ber, and the user ID. 
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The output of diskusg is normally the input to A ac *f. sk r 
acct (ADM)l which generates total accounting records that can pe 
merged with other accounting records, diskusg is normally run in 
dodisk [see accte/i (ADM)]. 


Examples ____ 

The following will generate daily disk accounting information: 

for i in /dev/dsk/Osl /dev/dsk/0s3; do 

diskusg $i > dtrrp. 'basename $i' & 

done 

diskusg -s dtirp.* I sort +0n +1 I acctdisk > disktacct 


Files 


/etc/passwd used for user ID to login name conversions 

See Also 

acct(ADM), acctsh(ADM), acct(F) 

Standards Conformance 

diskusg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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displaypkg 

display installed packages 

Syntax 

displaypkg 

Description 

Thed isp lay p kg command will list the names of all the AT&T-stvle 
UNIX packages that were installed using the installpkg command. 


See Also 

installpkg(ADM), removepkg(ADM) 

Note 

This command does not work on packages installed with 

custom(ADM). 
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divvy ___ 

disk dividing utility 

Syntax ____ 

divvy -b block_device -c character_device [-v virtual_drive] 
[-p physical_drive] [-i ] [-m ] [-n] 


Description 


divvy divides an Ms* (ADM) partition into a number of separate areas 
known as “divisions”. A division is identified by unique major and 
minor device numbers and can be used for a filesystem, swap area, or 
for isolating bad spots on the device. 


With divvy you can: 

• Divide a disk or /disk partition into separate devices. 


• Create new filesystems. 

• Change the size of filesystems. 

• Remove filesystems. 

Options 


Options to divvy are: 

-b block_device 

Major device number of block interface. 

-c character device 

Major device number of character interface. 

-v virtual device 

For dividing a virtual drive. 


-P 


physical drive 

For dividing one of several physical 
troller. 


disks that share the same con- 


-i Installation only. Disk being divided will contain a root filesystem 
on division 0. 
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-m Disk being divided should be made into a number of mountable 
filesystems. 

-n Installation only; non-interactive option. Disk being divided will 
contain the following: 

root fileystem on division 0 
swap on division 1 
u fileystem on division 2 
scratch fileystem on division 3 


Usage 


The device being divided must be a block device with a character 
interlace. For example, to use divvy on a device with a block- 
interface major number 1 and character interface number of 1, enter: 

divvy -b 1 -c 1 


The -v option specifies which virtual drive to divide. The default is 
the active drive. Here, “virtual drive” is the same as an MS-DOS par- 
rition. Virtual drive numbers are determined with the /disk (ADM) 


The -p option allows division of one of several physical disks sharing 
a controller, divvy defaults to the first physical device numbered “0 ” 
To access a second physical disk, use the -p 1 option. 


The-l option is used during installation. It specifies the device being 
divided will contain a root filesystem. With this option, device nodes 
are created relative to the new root, generally a hard disk, instead of 
the current root, often an installation floppy. A root filesystem, swap 
area, and recover area are created, divvy prompts for the size of the 
swap area. If the disk is large enough, then divvy prompts for a 
separate /u (user) filesystem, divvy also prompts for block-by-block 
control over the layout of the filesystem(s). If the root filesystem is 
large enough to require a scratch filesystem, (more than 40,000 
blocks) then divvy will prompt for whether one should be created. 
Usually, the root filesystem is the 


The -m option is used for initial installation on devices that will not 
be used as the root. It causes the user to be prompted for a number of 
filesystems. 


When divvy 


is invoked from the command line, you see a main menu: 


n[ame] 
c[reate] 
t type] 
p[ re vent] 
s[tart] 
e [nd] 


Name or rename a division. 

Create a new file system on this division. 

Select or change filesystem type on new filesystems. 
Prevent a new file system from being created on this 
Start a division on a different block. 

End a division on a different block. 
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r[estore] Restore the original division table. 

Please enter your choice or 'cf to quit: 

To choose a command, enter the first letter of the command, then press 
RETURN. 

The diwy division table might look something like this: 


+- 

| Name 

i- 

1 type 

i— 

| New FS 

j # | First Block | Last 
, - -- 

Block | 

H- 

| root 
| swap 

1 u 

+- 

| XENIX 
| NON FS 
| XENIX 

+■ 

| no 
| no 
| no 

l 0 I 01 

| 1 1 474031 

| 2 | 503691 

474021 
50368| 
703681 
_ 1 

| 

| NOT USED 

| no 

1 3 I "I 

1 

_ 1 

I 

| NOT USED 

| no 

1 4 | "I 

1 

_ 1 

1 

| recover 
| hdOa 

| NOT USED 
| NON FS 
| WHOLE DISK 

| no 
| no 
| no 

- - 

1 5 I "I 

| 6 | 703691 

| 7 | 0| 

-+-+-+- 

1 

703781 
706761 
-+ 


70379 IK blocks for divisions, 298 IK blocks reserved for the system 


divvy also displays information about block allocation for system 
tables and bad tracks. 

You can change the name of the device with the ‘n’ command, diwy 
prompts you for the division number (from the divvy table displayed 
above), then for a new name. 

The ‘c’ command causes a given division to become a new, empty 
filesystem when you exit from divvy . After using die c command, 
you will see a ‘yes’ in the ‘New File System? column. If you use 
command ‘p,’ the ‘yes’ in the ‘New File System? column will diange 
to a ‘no’, and the contents of the division will not change. The c 
command must be used when changing the size of a filesystem. 

With the ‘s’ or ‘start’ command, you can start a division on a different 
block number. With the ‘e’ or ‘end’ command, you can end a division 
on a different block number. 

You can use these commands to change the size of a partition. For 
example, if your disk is similar to the one in the sample diwy table 
above, and you want to make the u filesystem larger and the swap area 
smaller, do this: 

Make the swap area smaller with the ‘e’ command. 


Use the ‘s’ command to make the u division bigger. 
Use the ‘c’ command to recreate the u filesystem. 
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Note that if any of the divisions overlap, divvy will comDlain when 
you try to exit and put you back in the menus to correct the situation. 

reStores * e original partition table. This 
yoi started Y ^ Sen ° US mistake 311(1 want to ^tum to where 

divv y> y ou prompted whether you want to 
save any changes you made, or exit without saving the changes At 
this tune, you can also go back to the diwy menu, Ind mayX have 
de option to reinstall the original, default partition table. If you elect 
8a ^ e your changes, the new partition table will be written to the 
wdftecre^ed^ filesystems ( desi gnated with the V command) 


See Also 


fSCk(ADM »’ hd,M), 

Notes 


&h' q r es r ken l e l level S3pport from die device driver. If diwy 
lists the size of a disk as 0 blocks, or displays the following error 
messages, the device may not support dividing: 


cannot read division table 


or: 


cannot get drive parameters 

These errors may also occur if the prerequisite programs dparam 
fdisk and badtrk are not run correctly. upuram, 

bstallLff° f fileSySte ™ (such 38 /u ) after you have 
installed a XENIX filesystem, you will have to use the ‘c’ command to 

re-create the filesystem and reinstall the files that are kept there This 

bactoX^/f 6 HSt f ° r fi ? at fileSyStem has eftanged. 1 sureto 
rr P ,fnJ K “ “y filesystem you intend to change, using 

SB, 0 ' C r <c i before 

stalled^ f * * filesystem ’ the operating system must be rem- 

I^g mstallation, , if d* 5 diesystem on division 0 (generally root) 
becomes or remains large enough to require a scratch area during fsck 

be created^^The for whe dier one should 

(Th f filesystem, /dev/scratch, is used by auto¬ 

hoot if it runs fsck. /dev/scratch should also be entered when fsck 
prompts for a scratch file name, provided that the filesystem being 
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checked is not larger than the root filesystem.) If all disk divisions 
have been used upfdivyy will not prompt for a scratch filesystem, even 
if the root filesystem is large enough to require one. 

This utility uses 512-byte blocks. 


Value Added 


divvy is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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dlvr_audit _ 

produce audit records for subsystem events 

Syntax 


dlvr_audit [ -v ] tstamp event record pid cmd code [ args ... ] 

Description 


dlvrjiudit is used by programs implementing protected subsystems as 
the means for sending audit records to the audit subsystem. Because 
those programs do not have the writeaudit privilege, they invoke 
dlvrjiudit which sends the data over a message queue to the audit 
daemon which appends the record to the audit trail. Because 
alvr_auait is run as a child process of the process producing the 
record, it does not have the ability to write the audit device either 
The message queue that it uses is only usable by the audit user, so 
dlvr_audit must be run SUID to the audit user. The group is inherited 
from the invoking process and is checked against those groups associ¬ 
ated with protected subsystems. If the group cannot be identified with 
a protected subsystem, the record is ignored (so that general user pro¬ 
grams cannot flood the audit subsystem with invalid messages). 

The -v flag forces the program to report all of its actions. Normally, 
this flag is not used so that audit records can be made without the 
knowledge of the program user. 

The required arguments apply to all audit records. The tstamp argu¬ 
ment is the (ASCII number representation of the) time in seconds past 
Jan 1,1970 that the audit record was produced. The event argument is 
the number of the event type as described in <sys/audit.h>. Similarly 
the record argument is the audit record format type as described in 
<sys/audit.h>. The pid is the process ID of the event process. Cmd is 
the name of the protected subsystem command. Code is specific to 
the event type being generated. 

There may be 0 or more optional arguments depending on the code 
dlvrjiudit uses the extra arguments to fill in specific fields required 
by the particular record format. 

See Also 


authaudit(S), audit(HW), “Maintaining System Security,” chapter of 
the System Administrator’s Guide 
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dlvr audit is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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dmesg _ 

displays the system messages on the console 

Syntax 


dmesg [ - ] 

Description 


The dmesg command displays all the system messages that have been 
generated since the last time the system was booted. If the option — 
is specified, it displays only those messages that have been generated 
since the last time the dmesg command was performed. 

dmesg can be invoked periodically by placing instructions in the file 
/usr/lib/crontab . It can also be invoked automatically by the /etc/rc2 
scripts whenever the system is booted. See “Notes”, below. 

dmesg logs all error messages it prints in /usr/adm/messages. If 
dmesg is invoked automatically, the messages file continues to grow 
and can become very large. The system administrator should occa¬ 
sionally erase its contents. 

Files 


/etc/dmesg 

/usr/adm/messages 

/usr/adm/msgbuf 

Notes 


dmerg is included m this release for backwards compatibility only 
Oie device /dev/error provides a more flexible means of logging error 
messages, and is recommended over dmesg. See error (M) for more 
information. 

See Also 


cron(C), error(M), messages(M) 

dmesg was developed at the University of California, Berkeley, and is 
used with permission. 
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Value Added 


DMESG (ADM) 


dmesg is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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dparam _ 

displays/changes hard disk characteristics 

Syntax 

dparam [ -w ] 

dparam /dev/rhd[OI 1]0 [characteristics] 

Description 


£*cmemTv'inTfrrf ™ play \ 0r chan 8 es the hard disk characteris- 

a. wstffi 

ac“Sr e . diSk " USCd ’ ^ UtiHty “ 156 called befo* 

-w Causes a copy of /etc/masterboot to be copied to disk to 
ensure that non-standard hard disks are supported for the 
specified drive. This call must precede a call to write non¬ 
standard disk parameters for the desired parameters to be 
saved correctly in the masterboot block. 

c^ent'S 25? 0p f ti0nS ° r d '! sk characteristics, dparam prints the 

HaS hLv TT? h l f nStlCS (on the standard output) for the specified 
hard disk. These values are printed in the same order as the argument 

When writing characteristics for the specified hard disk dparam 
blodf CS Thp o UITent dlsk controller status and updates the masterboot 

JKfled ^STSf ? rdenng . 1S critical and must be entered as 
s^ahed below. All charactenstics must be entered when writing 
disk characteristics, otherwise an error is returned. Hard disk charac¬ 
tenstics (in respective order) are: 

number of cylinders 

total number of cylinders on the hard disk 

number of heads 

number of heads 


write cylinder 

hardware specific, consult your hardware manual 

write precompensation cylinder 

hardware specific, consult your hardware manual 


ecc 


number of bits of error correction on I/O transfers, 
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consult your hardware manual 

control very hardware specific, consult your hardware manual 
landing zone cylinder 

where to park heads after shutting down the system 

number of sectors per track 

number of sectors per track on the hard disk 


Examples. 

dparam -w 
dparam /dev/rhdlO 

dparam /dev/rhdOO 700 4 256 180 5 0 640 17 

Notes 


This utility changes the kernel’s view of the hard disk parameters. It 
may be subject to restrictions imposed by the hardware configuration. 


Value Added 


dparam is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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fdisk 

maintain disk partitions 

Syntax 


fdisk [ t-p] [-ad partition] [-c partition start size] [-f devicename] ] 

Description _ 

Sef& S n^r ati0n J lb0 , Ut disk partitions - f disk also creates and 
deletes disk partitions and changes the active partition fdisk func- 

Ek y 18 ?, SUpCr i et 0f the MS - D0S command of the same name 
fdisk is usually used interactively from a menu. 

^an^tenHmP It™ 081 fou * pMitioi } s - 0nl y one Partition is active 
at any given time. It is possible to assign a different operating system 

mi'! Once a partition is made active, theoperating sys- 

SlinT*™ »h”ff 1,on 1,00,5 ““‘y op- 

Utilit l T?* d . isk sizes in ^ks. The number of tracks 
nnmi? f r ^ d *5? “ e< l ual to the number of heads times the 
nr?h^l a J Cy i md f rS ' utiIit y does not allocate the first track 

TrMTY” on f y inder ^ disk when to “ Use Entire Disk for 

masterbZ ^nH 1S fh US ^ d ’ P** • fi ? ^ ck on ±e hard disk is reserved for 
V as t cy J mder IS generally used when running hard 
disk diagnostics. You should not allocate the last cylinder if you plan 
to run diagnostics on your hard disk. ^ ^ 

P -, e c xampl l’ ]j. a , disk has 4 heads an d 615 cylinders, it has 2460 
tracks, which fdisk reports as tracks 0-2459. If you choose the “Use 

Jacks TT ° pt . 10n ’ fdisk will create a XENIX partition on 

tracks 1-2455. Track 0 is reserved for masterboot and the last 

for h UNK”^ption 455 " 2459) 18 3SSigned with the “Use Entire Disk 

£2 wSk 31 ^ a “partition table” at the end of the master 
n^rt f,v!nc^ ^ able provid es the location and size of the 
E ,U p" ,°" tbe t dlsk ' Tkf Partition table also defines the active parti- 
tion. Each partition can be assigned to UNIX, DOS, or some other op¬ 
erating system. Once a DOS partition is set up, DOS files and direc- 

STaSn^ DOS Pf 1 ^ 00 ma y be accessed while from the 
UNK partition by means of the dos(C) commands. DOS mav be 
ooted without the DOS partition being active by entering “dos” at 
the boot prompt. See boot(HW). 8 
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P ’ These flags are used to invoke /disk non-interactively. The argu 
ment number, below, refers to a valid partition number (1- )• 

-d Prints out the disk partition table, one partition to a line. For each 
P partition, fdisk displays the following information: partition start 

stop size status type. 

-a number 

Activates partition number. 

-d number 

Deletes partition number. 

’ C ”create7a pSon, number, size tracks long ^gi^g ^ t tra ^ 
start The -c option is used to use the entire disk for UNIX, the 
appending of a dash to the end of the command lme accomplishes 
this, as in the following example: 

fdisk -c 1 1 - 

This syntax is used only during installation. If there are any existing 
partitions on the disk, this command will fail. 

f ”open device name and read the partition table associated with that 
device’s partition. The default is /dev/rhdOO. 


Options 


When invoked interactively (without the -p, -a,-d, or -c °pbon^, /di^ 
displays a prompt and a menu of five options. No changes art made; to 
the partition table on the disk until you enter q from the mam 
menu. 

1 ^Tfu^option 1 displays a table of information about each partition on 
the hard dlk. The PARTITION column gives the partition num¬ 
ber The STATUS column tells whether the partition is active (A) 
or inactive (I). TYPE tells whether the partition is a UNIX parti¬ 
tion a DOS partition, or “other”. The option also displays die 
starting track, ending track and total number of tracks in each par- 
tition. 
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2. Use Entire Disk for UNIX. 

fdisk creates one partition that includes all the tracks on the disk 
except the first track and the last cylinder. This partition is 
assigned to the UNIX system and is designated the active partition. 

3. Use Rest of Disk for UNIX. 

fdisk creates one partition that occupies the remainder of the disk. 
I nis partition is assigned to UNIX and is designated the active nar- 

titmn r 


4. Create UNIX Partition 

This option allows the creation of a partition by altering the parti¬ 
tion table, fdisk reports the number of tracks available for each 
partition and the number of tracks in use. fdisk prompts for the 
partition to create, the starting track and size in tracks. The change 
is written to the hard disk when you enter “q” from the main 
menu. 

5. Activate Partition 

This option activates the specified partition. Only one partition 
may be active at a time. The change is not effective until you exit. 
The operating system residing in the newly activated partition 
boots once the current operating system is halted. 

6. Delete Partition 

This option requests which partition you wish to delete, fdisk 
reports the new available amount of disk space in tracks The 
change is not effective until you exit. 

Exit the fdisk program by typing a ‘q’ at the main fdisk menu. Your 
changes are now written to the hard disk. 

Notes 


The minimum recommended size for a UNIX partition is 40 mega- 


Since fdisk is intended for use with DOS, it may not work with all od- 
erating system combinations. r 

OS/2 partitions are displayed as UNKNOWN. 

See Also 

dos(C), hd(HW) 


Value Added 


fdisk is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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fdswap _ 

swaps default boot floppy drive 


Syntax 

fdswap [onloff] 

Description___ 

fdswap tells the CMOS to swap the default floppy drive used to read 
boot information at boot time. For example, if your computer defaults 
to read boot information on drive A , fdswap on changes the default 
drive to drive B. 

fdswap with no arguments reports the current fdswap state, on or off. 
fdswap off switches the drive setting back to the default configuration. 
Changing the drives take effect on the next boot of the system. 

Notes___— 

Support for this functionality is only available on a small number of 
machines. The ROMs must recognize and interpret the CMOS flag 
that specifies that the floppy drives are swapped. 
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ff 

list file names and statistics for a filesystem 

Syntax _ 

/etc/ff [options] special 


Description 


The ff command reads the i-list and directories of the special file 

“W* 1S a - flle Sy A tem - 1110(16 data is saved for files which match 
* 6 H S6lec , tlon 6 " tena ; 9 u jP ut consists of the path name for each saved 
mode, plus other file information requested using the print options 
htow Oypat fl6lds 316 P° sitional - The output is produced in^node 
order; fields are separated by tabs. The default line produced by# is: 

path-name i-number 


With all options enabled, output fields would be: 
path-name i-number size uid 


The argument n in the option descriptions that follow is used as a 
decimal integer (optionally signed), where +n means more than n, -n 

houTperiod* 3 " ^ ” means exactl y n - A day is defined as a 24- 


-I 

Do not print the inode number after each path name. 

-1 

Generate a supplementary list of all path names for 
multiple-linked files. 

-P prefix 

The specified prefix will be added to each generated 
path name. The default is . (dot). 

-s 

Print the file size, in bytes, after each path name. 

-u 

Print the owner’s login name after each path name. 

-a n 

Select if the inode has been accessed in n days. 

-m n 

Select if the inode has been modified in n days. 

-c n 

Select if the inode has been changed in n days. 

-n file 

Select if the inode has been modified more recently 
than the argument file . 
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-i inode-list Generate names for only those inodes specified in 
inode-list. 

See Also 

find(C), ncheck(ADM) 


Notes 


If the -1 option is not specified, only a single path name out of all pos¬ 
sible ones is generated for a multiple-linked inode. If -1 is specified, all 
possible names for every linked file on the file system are included m 
the output. However, no selection criteria apply to the names gen¬ 
erated. 


This command only works on UNIX filesystems. 
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fixperm _ 

correct or initialize file permissions and ownership 

Syntax _ 

fixperm [ -cfgilnpsvwDS [ -d package] ] specfile 


Description 


For each line in the specification file specfile, fixperm makes the 
listed pathname conform to a specification, fixperm is typically used 
to cotrfigure a UNIX system upon installation It can ordTSS 

,n y vnleH P f erUSer ’ works from the root directory. 

invoked from any other directory, incorrect results will be returned. 

TOnsiste C of ehher ? C h3S thC f ° ll0Wlng format: Each non-blank line 
ZTt fvlm a comment or an item specification. A comment is 

item 1 c l f f , P d ? Ign # U P 10 the end of the line. There is one 

ine V User 311(1 group id num bers must be speci¬ 
fied at the top of the specification file for each user and group men- 
tioned m the file. The syntax for the definition section is simple toe 
first field indicates the type of id (either uid or gid), the second con- 

ssfssr for,d -^ “ rd is ,he 


uid 


root 


An item specification consists of a package specifier, a permission 

Ele Ca thefile 0 n ner and / roup speci f lc ations, *e number of links on 
the rile, the file name, and an optional volume number. 

^Hr^ Cka ^ Spe j—u is an arbitrar y string which is the name of a 
package within a distribution set. A package is a set of files. 

P ac kage specifier is a permission specification. The permis¬ 
sion specification consists of a file type, followed by a numeric per- 

Ea?teS^ ClflCatl ° n ' ^ ltem Specification is one of the following 


x Executable, 

a Archive. 

e Empty file (create if -c option given). 


March 15,1989 


FIXPERM-1 











FIXPERM (ADM) 


FIXPERM (ADM) 


b Block device, 

c Character device, 

d Directory, 

f Text file. 


P 

o 


Named pipe. 


OK It indicates to fixperm that there should be no file type 
checking allowing any format or contents in what would nor¬ 
mally be the header section of an executable.^ For example, data 
files and encrypted files should be of type “o”. 


If the item specification is used as an upper-case letter, 
associated with it is optional, and fixperm will not return 
sage if it does not exist. 


then the file 
an error mes- 


The numeric permission conforms to the scheme described in 
chmod(C). The owner and group permissions are in the third column 
separated by a slash: e.g.,: “bin/bin”. The fourth column indicates the 
number of links. If there are links to the file^fiie next line contains the 
linked filename with no other information. The fifth column is a path¬ 
name. The pathname must be relative, i.e., not preceded by a slash 
The sixth column is only used for special files, giving the major 
and minor device numbers, or volume numbers. 


Options 


The following options are available from the command line, unless 
otherwise noted: 

-c Create empty files and missing directories. Also or creates (or 
modifies) device files. 

-g Instructs fixperm to list devices as specified in the peimlist (similar 
to the -f flag, which lists files on standard output). No changes are 
made as a result of this flag. 

^Process input lines beginning with given package specifier string 
(see above). For instance, -dBASE processes only items specified 
as belonging to the Basic utilities set. The default action is to pro¬ 
cess all lines. 

U ^Like -u, but processes items that are not part of the given package. 
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-f List files only on standard output. Does not modify target files. 

-i (Available from a program or shell script only) 

Check only if the selected packages are installed. Return values 


package completely installed 
package not installed 
package partially installed 


■* gitfifif 8 md dlrectories on standa rd output. Does not modify tar- 


-n Report errors only. Does not modify target files. 

P t faU i l Uid ( gid found “ ^c/passwd and /etc/group with 

he value found m the permhst. Because UNIX and XENIX have 

ssru"S nk b^r d H a ? <i , 8ids , (for 

r , 9 ana 1 A±iN Y c bin=3) the default value is gleaned from thp 

te /ETrom the t n /gr ° U r 1 ? lis ° ption forces the valu es to 
D taxen trom the perms list. It also generates a warning if the 

permhst doesn t /etc/passwd and /etc/group. g 

' D files. dirCCt0rieS ° nly ° n St3ndard OUtput Does not mod ify target 

" V wofot^nE^ is f CS a , c °mplaint if executable files are 
stripped WaPPed ® Xed St3Ck ’ not separate 1 “d D > or not 


■s Modify special device files in addition to the rest of the permlist. 

W located^ (What V ° 1Ume) thC specified files or directories are 


-S Issues a complaint if files are not in x.out format. 


^hi^onTwL m° HneS mak - e a distribution and invoke tar(C) to 
archive only the files m perms.mst on /dev/sample: V ; 


/etc/fixperm -f /etc/perms/inst > list 
tar cfF /dev/sample list 


This example reports BASE package errors: 

/etc/fixperm -nd BASE /etc/perms/* 
/etc/fixperm -nd BASE /etc/perms /filename 


or 
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Notes --- 

Usually fixperm is only run by a shell script at installation. 

See Also ______ 

custom (ADM) 

Value Added __ 

fixperm is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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fsave _ 

interactive, error-checking filesystem backup 

Synopsis 


fsave filesystem [ backupinfo ] [ mediainfo ] [ sitename ] 

Description 


fsave is used by fsphoto (ADM) to provide a semi-automated interface 
to xbackup (ADM) and cpio(C) for backing-up filesystems. Human 
intervention is required to mount and dismount tapes or floppies at the 
appropriate times, but is kept to a minimum to reduce the potential for 
error. 

The operator is prompted each time some action is required, such as 
mounting or unmounting a tape or floppy. These prompts, and their 
possible selections, are described below. 

For all prompts, an answer of h, H, or ? will display a short summary 
or the possible answers. 

Filesystem dump (backup) 

The following prompt displays the defaults (gleaned from the 
schedule database file) and presents options to alter them: 

Level dumplevel dunp of filesystem filesystem , date 
media size: size feet [or Kb] 
media drive: drive 

This media will be saved for howlong, and is howvital. 

M) ounted volume, P) ostpone, C)heck or F)ormat volumes, R) Retension or H)elp: 

The values displayed dictate the following instructions: filesystem is 
to be backed-up using size-foot long magtapes (or size-kilobyte big 
floppies) mounted on drive drive . The media will be saved for how- 
l °ng (“1 year,” “2 months,” etc.), and being a level dumplevel dump, 
is howvital (“critical,” “precautionary,” etc.). 

The menu options are: 

m A volume of the asked for size has been mounted (write- 

enabled), so begin the dump. 

mnewsize Insufficient volumes of the originally asked for size are 
available, so a newsize big volume has been mounted 
instead. If the dump extends across more than one volume, 
each volume must be of the same size. 
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a Postpone this backup until later (fsphoto will automatically 

retry this filesystem next time it is run). 

c Recheck the volumes used to backup filesystem for errors. 

This answer is useful when a dump mysteriously fails and 
fsave is starting over from the beginning, but the operator 
doesn’t believe there really is a problem (for example, the J 
tape drive was accidentally left offline or the floppy door ^^0 

was left open), and wants to check the volumes again. 

f Format the currently mounted volume (useful mainly for 

floppies). 

r Retension cartridge tape using /usr/bin/tape. 

If multiple volumes are required, backup will pause for the next 

volume to be mounted. Be certain to keep track of the volume order. 


Format check 

The format of “critical’ ’ volumes are checked using dumpdir (ADM): 


Check vital volumes for format errors 

M)ounted first volume, S)kip format check, or H)elp. 


The menu options are: 

m The first volume has been (or still is) mounted, and dump¬ 

dir can now check the volume format. 


Skip checking the volume format, and continue on to the 
read error check (below). 


The format is not always checked, but when it is, the first volume writ¬ 
ten must be mounted. 


Read error check 

All volumes created using xbackup( ADM) are read using 
xrestore (ADM), which checks for errors during reading. If an error 
occurs, the dump is declared unsuccessful and is retned from the 
beginning. 


Check vital volumes for read errors 

M)ounted which volume, E)rror on previous volume, D)one 


, S)kip checks, or H)elp: 


The menu options are: 


m 


The which (“first” or “next”) volume has been mounted 
on the drive and is ready to be checked for read errors. 
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An error occurred on the last volume checked, and the 
dump should be retried. 

All volumes have been checked and no errors occurred, so 
the filesystem has been successfully backed-up- This 
backup is done. 

Don’t bother (skip) checking the rest of the volumes for 
read errors. 


Every volume should be checked for read errors; xrestore requires the 
volumes to be checked in first-to-last order. Volumes that produce 
read errors should be marked “suspect,” discarded and the dump run 
once again. y 


After the backup has been successfully performed, instructions are 
given on how to label the volumes. 


Arguments 


/save is normally run by fsphoto , which passes all the 
ments based on the schedule (ADM) database. 


proper argu- 


filesystem 

The filesystem to be backed-up. 


dumpinfo 

A set of blank-separated strings that give some optional informa¬ 
tion about this backup: 


dumplevel size savetime importance marker 

Each of these component strings may be quoted and can thus con¬ 
tain spaces. 

dumplevel The level of the dump to be performed. This is a single 
digit from 0 to 9 (passed to dump), or the letter x (which 
means no dump is to be done). The default is to per- 
form a level 0 dump. 

size The size of the media volumes that should be used. 

pis should be in feet for tapes and kilobytes for 
floppies. A size of - means to use the first size listed in 
mediainfo . This is the default. 

savetime How long this backup is to be saved (for example “3 
months”). Default is “1 year.” ’ 

importance 

How important is this backup? (For example, “criti¬ 
cal” or “precautionary.”) Those which are “critical” 
have their format checked by dumpdir. Default is 
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“important.” 

marker Either “none” (the default) or an additional label to 
place on each volume (for example, a pink sticker ). 

A typical dumpinfo might look like: 

9 1200 "2 weeks" useful "a blue X" 


which specifies that a level 9 dump is to be done on a 1200 foot 
tape (or 1200 kilobyte floppy) which will be saved for 2 weeks and 
is to be marked with a blue cross (in addition to a more descriptive 
label). This backup is merely considered “useful” and thus will 
not be checked by dumpdir. 


me T£oi blank-separated strings that give some optional informa¬ 
tion about this the media to be used: 


drive d density sizes... \format ] 
drive k sizes... [format] 

drive The name of backup device to use. The default is 

Idev/rmtO. 

k sizes... If k is specified, drive is assumed to be a floppy, and 
the list of sizes which follow define the allowable 
capacities of the floppies that can be used (in kilo¬ 
bytes). 

d density sizes... * . . 

Otherwise, d must be specified. In this case, drive is 
assumed to be a magtape at density BPI , in one of 
the possible sizes (in feet). 

format The UNIX command used to format the tape or 

floppy so described. 

A mediainfo describing 9-track magtape would be: 

media /dev/rmtO d 1600 2400 1200 600 
media /dev/rmt2 d 800 1400 1200 600 

which specifies that Idev/rmtO is a 1600 BPI magtape capable of 

handling 2400, 1200, and 600 foot reels, and that Idevlrmtl is the 

800 BPI device. 

A floppy might be described with: 

media /dev/fdO k 1024 format /dev/fdO 
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which describes device IdevlfdO as a megabyte (1024 kilobytes) 
floppy formatted by the command: 

format /dev/fdO 

sitename 

Where this backup was made (for example, the name of the com¬ 
pany or which building). Note that the uucp(C ) nodename from 
letdsystemid is automatically placed on the volume labels. 

Only the super-user can execute the fsave command. 

Files 


/etc/systemid 

Name of this machine. 

/etc/ddate 

backup -maintained record of last time each filesystem was 
backed-up. 

/dev/tty 

Always-existent character-special device. 

See Also 


fsphoto(ADM), schedule(ADM), xbackup(ADM), dumpdir(ADM) 
xrestore(ADM), cpio(C), basename(C) 

Diagnostics 


A successful backup exits successfully (0), but errors generate a com¬ 
plaint and an exit status of 1. fsave complains about illegal or 
incorrect arguments, and exits with a status of 2. 

If the backup of filesystem is postponed, fsave exits with a status of 3. 

Value Added 


fsave is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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fsck, dfsck _ 

checks and repairs filesystems 

Syntax 

/etc/fsck [ options ] [ filesystem ]... 

/etc/dfsck options 1] filesysl ... -[options2] filesys2 ... 


Description 


fsck audits and interactively repairs inconsistent conditions for all 
supported filesystems. If the filesystem is consistent, the the number 
of files, number of blocks used, and number of blocks free are 
reported. If the filesystem is inconsistent, the operator is prompted for 
concurrence before each correction is attempted. It should be noted 
that most corrective actions result in some loss of data. The amount 
and severity of the loss may be determined from the diagnostic output. 
(An experienced operator can resolve discrepancies manually using 
fsdb( ADM), the filesystem debugger.) The default action for each 
consistency correction is to wait for the operator to respond yes or 
“no”. If the operator does not have write permission fsck defaults to 
the action of the -n option. 


The following flags are interpreted by fsck: 

-C\clustersize\ 

Converts the named S51K filesystem into an AFS (Acer Fast 
Filesystem). The -s option must also be present. The cluster - 
size argument must be a power of 2 and less than 16 (8 is the 
recommended value). The increase in speed that is possible 
with a fast filesystem will not be immediately apparent; it will 
take affect only with the new files added to the filesystem. 
There is little or no benefit in transforming a filesystem that is 
nearly full; if it is within a few blocks of being full, the conver¬ 
sion will not work. (This option can only be used to convert an 
S51Kfileystem.) 


-y Assumes a yes response to all questions asked by fsck. 

-n Assumes a no response to all questions asked by fsck', do not 

open the filesystem for writing. 

-sb:c Ignores the actual free list and (unconditionally) reconstructs a 
new one by rewriting the super-block of the filesystem. The 
filesystem must be unmounted while this is done. 
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The -s b:c option allows for creating an optimal free-list organ- 
ization. The following forms are supported: 

-s 

-sBlocks-per-cylinder:Blocks-to-skip (filesystem interleave) 
(for anything else) 

M b:c is not given, then the values used when the filesystem 
was created are used. If these values were not specified, then a 
reasonable default value is used. 

-S Conditionally reconstructs the free list. This option is like - 
sb:c above except that the free list is rebuilt only if there are 
no discrepancies discovered in the filesystem. Using -S forces 
a ^ ’ response to a11 questions asked by fsck. This option is 
useful for forcing free list reorganization on uncontaminated 
filesystems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses 

a scratch file. If the -t option is specified, the file named in the 
next argument is used as the scratch file, if needed. Make cer¬ 
tain you leave a space between the -t and the filename, or fsck 
will use the entire filesystem as a scratch file and erase the 
entire disk. If you created a scratch filesystem during installa¬ 
tion then you can use /dev/scratch as the filename, provided 
fiiat the filesystem being checked is no larger than the root 
filesystem. Without the -t flag, fsck prompts the operator for 
the name of the scratch file. The file chosen should not be on 
die filesystem being checked, and if it is not a special file or 
did not already exist, it is removed when fsck completes. If the 
system has a large hard disk there may not be enough space on 
another filesystem for the scratch file. In such cases, if the sys¬ 
tem has a floppy drive, use a blank, formatted floppy in the 
floppy drive with (for example) /dev/fdO specified as the 
scratch file. 

-q Quiet fsck. Do not print size-check messages in Phase 1. 
Unreferenced fifo5 files will selectively be removed. Jf fsck 
requires it, counts in the superblock will be automatically fixed 
and the free list salvaged. 

-D Directories are checked for bad blocks. Useful after system 
crashes. 

-f Fast check. Check block and sizes (Phase 1) and check the 
free list (Phase 5). The free list will be reconstructed (Phase 6) 
if it is necessary. 

-rr Recovers the root filesystem. The required filesystem argu¬ 
ment must refer to the root filesystem, and preferably to the 
block device (normally /dev/root). This switch implies -y and 
overrides -n . If any modifications to the filesystem are 
required, the filesystem will be automatically mounted. 
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-c Causes any supported filesystem to be converted to the type of 
the current filesystem. The user is prompted to verify the 
request for each filesystem that requires conversion unless the 
-y option is specified. It is recommended that every filesystem 
be checked with this option while unmounted. To update the 
active root filesystem, it should be checked with: 

fsck -c -rr /dev/root 

If no filesystems are specified, fsck reads a list of default filesystems 
from the file /etc/checklist. 

Inconsistencies checked are as follows: 

• Blocks claimed by more than one inode or the free list 

• Blocks claimed by an inode or the free list outside the range of 
the filesystem 

• Incorrect link counts 

• Size checks: 

Incorrect number of blocks 
Directory size not 16-byte aligned 

• Bad inode format 

• Blocks not accounted for anywhere 

• Directory checks: 

File pointing to unallocated inode 
Inode number out of range 

• Super block checks: 

More than 65536 inodes 

More blocks for inodes than there are in the filesystem 

• Bad free block list format 

• Total free block or free inode count incorrect 

Orphaned files and directories (allocated but unreferenced) are, with 
the operator’s concurrence, reconnected by placing them in die 
lost+found directory. The name assigned is the inode number. The 
only restriction is that the directory lost+found must preexist in the 
root of the filesystem being checked and must have empty slots m 
which entries can be made. This is accomplished by making 
lost+found, copying a number of files to the directory, and then 
removing them (before fsck is executed). 
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£ ^>°£ W / 0 fil f ystem c , hecks on two different drives simultane- 
sly. Optionsl and options2 are used to pass options to fsck for the 

groups.^ ° f filesystems - A - is the separator between filesystem 

The dfsck program permits an operator to interact with two fsck pro- 
^ams at once. To help m this, dfsck displays the filesystem name P for 
ach message to the operator. When answering a question from dfsck 
die operator must preface the response with a 1 or a 2 (indicating that 
the answer refers to the first or second filesystem group). 

Do not use dfsck to check the root filesystem. 


Files 


/etc/checklist 

/etc/default/boot 

See Also 


Contains default list of filesystems to check 
Automatic boot control 


autoboot(ADM), fsdb(ADM), checklist(F), filesystem(F), init(M) 

Notes 


Jif S C S / ^ SCmd ' ,l,7T, ' £ P™*™™ »» each file sys . 

tern type, each of these programs applies some appropriate heuristic to 

checks me Whether 1116 su PP lied special file is of the type for which it 

{em iTlr^r amounted non-raw filesystem unless the filesys¬ 
tem is the root filesystem or unless the -n option is specified and no 
wntrng out of the filesystem will take place P If any such attempt is 
made, a warning is displayed and no further processing of the filesys- 
tem is done for the specified device. ^ 

wIv°to g ten h ^ 8 fi, raW t device is alm «st always faster, there is no 
way to tell if the filesystem is mounted. And cleaning a mounted 

filesystem will almost certainly result in an inconsistent superblock. 

Warning 

Filesystems created under UNIX-86 version 3.0 are not supported 
under UNIX System V/386 3.2 because the word ordering in type long 
variables has changed, fsck is capable of auditing and repairing UNIX 
version 3.0 file systems if the word ordering is correct. 

^, r00 ‘,fi^ esy stem,, “fsck -rr /dev/root” should be run. For all 
shouldbe^sed" 18 ’ *** /dev/?? ” on the unmounted block device 
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Initialization Phase 

Command syntax is checked. Before the filesystem checkcan be per¬ 
formed, fsck sets up certain tables and opens some files. The fsck ter¬ 
minates on initialization errors. 

General Errors_____ 

Three error messages may appear in any phase. While they seem to 
offer the option to continue, it is generally best to regard them as fatal, 
end the run, and investigate what may have caused the problem. 

CAN NOT SEEK: BLKB (CONTINUE?) 

The request to move to a specified block number B in tne 
filesystem failed. The occurrence of this error condition 
indicates a serious problem (probably a hardware failure) 
that may require additional help. 

CAN NOT READ: BLK B (CONTINUE?) 

The request for reading a specified block number B in the 
filesystem failed. The occurrence of this error condition 
indicates a serious problem (probably a hardware failure) 
that may require additional help. 

CAN NOT WRITE: BLKB (CONTINUE?) , , 

The request for writing a specified block number B m the 
filesystem failed. The disk may be write-protected. 


Meaning of YesINo Responses 


Prompt 

n(no) 

y(yes) 

CONTINUE? 

Terminates program. 

(This is the recom¬ 
mended response.) 

Attempts to continue to 

run filesystem check. 
Often, however, the 
problem persists. The 
error condition does not 
allow a complete check 
of the filesystem. A 
second run of fsck 
should be made to 
recheck this filesystem. 
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This phase checks the inode list. 


Meaning of Yes/No Responses—Phase 1 


Prompt 

n(no) 

y(yes) 

CONTINUE? 

Terminates the pro¬ 
gram. 

(Recommended 

response.) 

Continues with the pro¬ 
gram. 

This error condition 
means that a complete 
check of the filesystem 
is not possible. A 
second run of fsck 
should be made to 
recheck this filesystem. 

CLEAR? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Deallocates i-node I by 
zeroing its contents. 

This may invoke the 
UNALLOCATED error 
condition in Phase 2 for 
each directory entry 
pointing to this i-node. 


Phase 1 Error Messages 

UNKNOWN FILE TYPE 1=1 (CLEAR?) 

The mode word of the i-node / suggests that the i-node is not 
a pipe, special character i-node, regular i-node, or directory 
i-node. 

LINK COUNT TABLE OVERFLOW (CONTINUE?) 

An internal table for fsck containing allocated i-nodes with a 
link count of zero has no more room. 

B BAD 1=1 

I-node I contains block number B with a number lower than 
the number of the first data block in the filesystem or greater 
than the number of the last block in the filesystem. This 
error condition may invoke the EXCESSIVE BAD BLKS 
error condition in Phase 1 if i-node I has too many block 
numbers outside the filesystem range. This error condition 
invokes the BAD/DUP error condition in Phase 2 and Phase 
4. 

EXCESSIVE BAD BLOCKS 1=1 (CONTINUE?) 

There is more than a tolerable number (usually 10) of blocks 
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with a number lower than the number of the first data block 
in the filesystem or greater than the number of the last block 
in the filesystem associated with i-node /. 

B DUP 1=1 

I-node I contains block number B, which is already claimed 
by another i-node. This error condition may invoke the 
EXCESSIVE DUP BLKS error condition in Phase 1 if 
i-node I has too many block numbers claimed by other 
i-nodes. This error condition invokes Phase IB and the 
B AD/DUP error condition in Phase 2 and Phase 4. 

EXCESSIVE DUP BLKS 1=1 (CONTINUE?) 

There is more than a tolerable number (usually 10) of blocks 
claimed by other i-nodes. 

DUP TABLE OVERFLOW (CONTINUE?) 

An internal table in fsck containing duplicate block numbers 
has no more room. 

POSSIBLE FILE SIZE ERROR 1=1 

The i-node I size does not match the actual number of blocks 
used by the i-node. This is only a warning. If the -q option 
is used, this message is not printed. 

DIRECTORY MIS ALIGNED 1=1 

The size of a directory i-node is not a multiple of 16. This is 
only a warning. If the -q option is used, this message is not 
printed. 

PARTIALLY ALLOCATED INODE 1=1 (CLEAR?) 

I-node I is neither allocated nor unallocated. 


Phase IB: Rescan for More DUPS 


When a duplicate block is found in the filesystem, the filesystem is 
rescanned to find the i-node that previously claimed that block. When 
the duplicate block is found, the following information message is 
printed: 

B DUP 1=1 

I-node / contains block number B , which is already claimed 
by another i-node. This error condition invokes the 
BAD/DUP error condition in Phase 2. I-nodes with overlap¬ 
ping blocks may be determined by examining this error con¬ 
dition and the DUP error condition in Phase 1. 
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This phase removes directory entires pointing to bad inodes found in 
Phase 1 and phase IB. 


Meaning of Yes/No Responses—Phase 2 


Prompt n(no) 

y(yes) 

FIX? 

Terminates the program 
since fsck will be 
unable to continue. 

In Phase 2, a y(yes) 
response to the FIX? 
prompt says: Change 
the root i-node type to 
“directory.” 

If the root i-node data 
blocks are not directory 
blocks, a very large 
number of error condi¬ 
tions are produced. 

CONTINUE? 

Terminates the pro¬ 
gram. 

Ignores DUPS/BAD 
error condition in root 
i-node and attempt to 
continue to run the 
filesystem check. 

If root i-node is not 
correct, then this may 
result in a large number 
of other error condi¬ 
tions. 

REMOVE? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Removes duplicate or 
unallocated blocks. 


Phase 2 Error Messages 

ROOT INODE UNALLOCATED. TERMINATING 

The root i-node (always i-node number 2) has no allocate 
mode bits. The occurrence of this error condition indicates a 
serious problem. The program stops. 
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ROOT INODE NOT DIRECTORY (FIX?) 

The root i-node (usually i-node number 2) is not directory 
i-node type. 

DUPS/B AD IN ROOT INODE (CONTINUE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks in 
the root i-node (usually i-node number 2) for the filesystem. 

I OUT OF RANGE 1=1 NAME=F (REMOVE?) 

A directory entry F has an i-node number I that is greater 
than the end of the i-node list. 

UNALLOCATED 1=1 0WNER=0 MODE=M SIZE=S 
MTIME=T NAME=F (REMOVE?) 

A directory entry F has an i-node / without allocate mode 
bits. The owner O, mode Af, size S, modify time T, and 
filename F are printed. If the filesystem is not mounted and 
the -n option was not specified, the entry is removed auto¬ 
matically if the i-node it points to is character size 0. 

DUP/BAD 1=1 0WNER=0 MODE=M SIZE=S MTIME=T 
DIR=F (REMOVE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with directory entry F, directory i-node /. The 
owner O, mode M, size S, modify time T, and directory name 
F are printed. 

DUP/BAD 1=1 0WNER=0 MODE=M SIZE=S MTIME=T 
FILE=F (REMOVE?) 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with file entry F, i-node /. The owner O, mode M, 
size S , modify time T, and filename F are printed. 

BAD BLK B IN DIR 1=1 0WNER=0 MODE=M SIZE=S 
MTIME=T 

This message only occurs when the -D option is used. A bad 
block was found in DIR i-node /. Error conditions looked 
for in directory blocks are nonzero padded entries, incon¬ 
sistent and entries, and embedded slashes in the 
name field. This error message means that the user should at 
a later time either remove the directory i-node if the entire 
block looks bad or change (or remove) those directory 
entries that look bad. 

Phase 3: Check Connectivity 


This phase is concerned with the directory connectivity seen in Phase 

2 . 
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Meaning of Yes/No Responses—Phase 3 


Prompt 

n(no) 

y(yes) 

RECONNECT? 

Ignores the error condi¬ 
tion. 

This invokes the 

UNREF error condition 
in Phase 4. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Reconnects directory 
i-node I to the filesys¬ 
tem in directory for lost 
files (usually 

lost+found). 

This may invoke a 
lost+found error condi¬ 
tion if there are prob¬ 
lems connecting direc¬ 
tory i-node I to 
lost+found. 

This invokes CON¬ 
NECTED information 
message if link was 
successful. 


Phase 3 Error Messages 

UNREF DIR 1=1 0WNER=0 MODE=M SIZE=S MTIME=T 
(RECONNECT?) 

The directory i-node I was not connected to a directory entry 
when the filesystem was traversed. The owner O, mode M, 
size S, and modify time T of directory i-node / are printed. 
The fsck program forces the reconnection of a nonempty 
directory. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the 
filesystem; fsck ignores the request to link a directory in 
lost+found. This invokes the UNREF error condition in 
Phase 4. Possible problem with access modes of lost+found. 

SORRY. NO SPACE IN lost+found DIRECTORY 

There is no space to add another entry to the lost+found 
directory in the root directory of the filesystem; fsck ignores 
the request to link a directory in lost+found. This invokes 
the UNREF error condition in Phase 4. Clean out unneces¬ 
sary entries in lost+found or make lost+found larger (see 
Procedure 5.2). 

DIR 1=11 CONNECTED. PARENT WAS 1=12 

This is an advisory message indicating a directory i-node II 
was successfully connected to the lost+found directory. The 
parent i-node 12 of the directory i-node II is replaced by the 
i-node number of the lost+found directory. 
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This phase checks the link count information seen in Phases 2 and 
3. 



Meaning of Yes/No Responses—Phase 4 


Prompt 

n(no) 

y(yes) 

RECONNECT? 

Ignores this error con¬ 
dition. 

This invokes a CLEAR 
error condition later in 
Phase 4. 

Reconnect i-node I to 
filesystem in the direc¬ 
tory for lost files (usu¬ 
ally lo st + found). 

This can cause a 
lost+found error condi¬ 
tion in this phase if 
there are problems con¬ 
necting i-node / to 
lost+found. 

CLEAR? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Deallocates the i-node 
by zeroing its contents. 

ADJUST? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Replaces link count of 
file i-node / with Y. 

FIX? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Replaces count in 
super-block by actual 
count. 




Phase 4 Error Messages 

UNREF FILE 1=1 0WNER=0 MODE=M SIZE=S MTIME=T 
(RECONNECT?) 
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I-node / was not connected to a directory entry when the 
filesystem was traversed. The owner O, mode M, size S, and 
modify time 7 of i-node / are printed. If the -n option is 
omitted and the filesystem is not mounted, empty files are 
cleared automatically. Nonempty files are not cleared. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the 
filesystem; fsck ignores the request to link a file in 
lost+found. This invokes the CLEAR error condition later 
in Phase 4. Possible problem with access modes of 
lost+found. 

SORRY. NO SPACE IN lost+found DIRECTORY 

There is no space to add another entry to the lost+found 
directory in the root directory of the filesystem; fsck ignores 
me request to link a file in lost+found. This invokes the 
CLEAR error condition later in Phase 4. Check size and 
contents of lost+found. 


(CLEAR) 

The i-node mentioned in the immediately previous UNREF 
error condition cannot be reconnected. 

COUNT FILE 1=1 0WNER=0 MODE=M SIZE=S 
MTIME=T COUNT=X SHOULD BE Y (ADJUST?) 

pie link count for i-node /, which is a file, is X but should be 
Y. The owner O, mode M, size S, and modify time T are 
printed. 

LINK COUNT DIR 1=1 0WNER=0 MODE=M SIZE=S 
MTIME=T COUNT=X SHOULD BE Y (ADJUST?) 

The link count for i-node /, which is a directory, is X but 
should be Y. The owner O, mode M, size S, and modify time 
T of directory i-node / are printed. 


LINK COUNT F 1=10WNER=0 MODE=M SIZE=S MTIME=T 
COUNT=X SHOULD BE Y (ADJUST?) 

The link count for F i-node I is X but should be T. The 
filename F, owner O, mode M, size S, and modify time T are 
printed. 


UNREF FILE 1=1 0WNER=0 
(CLEAR?) 


MODE=M SIZE=S MTIME=T 


I-node /, which is a file, was not connected to a directory 
entry when the filesystem was traversed. The owner O, 
mode M, size S, and modify time T of i-node I are printed. If 
the -n option is omitted and the filesystem is not mounted, 
empty files are cleared automatically. Nonempty directories 
are not cleared. 
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UNREF DIR 1=1 0WNER=0 MODE=M SIZE=S MTIME-T 

(CLEAR?) . „ ,. 

I-node /, which is a directory, was not connected to a direc¬ 
tory entry when the filesystem was traversed. The owner O, 
mode M, size S, and modify time T of i-node I are printed. If 
the -n option is omitted and the filesystem is not mounted, 
empty directories are cleared automatically. Nonempty 
directories are not cleared. 

BAD/DUP FILE 1=1 OWNER=0 MODE=M SIZE=S MTIME=T 

(CLEAR?) , , , . . ., . 

Phase 1 or Phase IB found duplicate blocks or bad blocks 
associated with file i-node I. The owner O, mode M, size S, 
and modify time T of i-node I are printed. 

BAD/DUP DIR 1=1 0WNER=0 MODE=M SIZE=S MTIME=T 

(CLEAR?) , , , , , ,. , 

Phase 1 or Phase IB found duplicate blocks or bad blocks 

associated with directory i-node I. The owner O, mode M, 
size S, and modify time T of i-node / are printed. 

FREE INODE COUNT WRONG IN SUPERBLK (FIX?) 

The actual count of the free i-nodes does not match the 
count in the super-block of the filesystem. If the -q option is 
specified, the count will be fixed automatically in the super¬ 
block. 


Phase 5: Check Free List 


This phase checks the free-block list. 


Meaning of Yes/No Responses—Phase 5 


Prompt 

n(no) 

y(yes) 

CONTINUE? 

Terminates the pro¬ 
gram. 

Ignores rest of the 

free-block list and con¬ 
tinue execution of fsck. 
This error condition 
will always invoke 
BAD BLKS IN FREE 
LIST error condition 
later in Phase 5. 

( CAntimipH^ 
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Prompt II n ( no ) 

y(yes) 

FIX? 

Ignores the error condi¬ 

tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Replaces count in 
super-block by actual 
count. 

SALVAGE? 

Ignores the error condi¬ 
tion. 

A NO response is only 
appropriate if the user 
intends to take other 
measures to fix the 
problem. 

Replaces actual free- 
block list with a new 
free-block list. 

The new free-block list 
will be ordered accord¬ 
ing to the gap and 
cylinder specs of the -s 
or -S option to reduce 
time spent waiting for 
the disk to rotate into 
position. 


Phase 5 Error Messages 

EXCESSIVE BAD BLKS IN FREE LIST (CONTINUE?) 

The free-block list contains more than a tolerable number 
(usually 10) of blocks with a value less than the first data 
block in the filesystem or greater than the last block in the 
filesystem. 

EXCESSIVE DUP BLKS IN FREE LIST (CONTINUE?) 

Jb e n Ce ~, , 1 ! st stains more than a tolerable number 
(usually 10) of blocks claimed by i-nodes or earlier parts of 
the free-block list. 

BAD FREEBLK COUNT 

The count of free blocks in a free-list block is greater than 

rf a t-\ O' error condition will always invoke 
the BAD FREE LIST condition later in Phase 5. 

X BAD BLKS IN FREE LIST 

X blocks in the free-block list have a block number lower 
than die first data block in the filesystem or greater than the 
last W°ck m the filesystem. This error condition will always 
mvoke the BAD FREE LIST condition later in Phase 5. 
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XDUPBLKS IN FREE LIST 

X blocks claimed by i-nodes or earlier parts of the tree-list 
block were found in the free-block list. This eiror condition 
will always invoke the BAD FREE LIST condition later in 
Phase 5. 


X BLK(S) MISSING , . 

X blocks unused by the filesystem were not found in the 
free-block list. This error condition will always mvoke the 
BAD FREE LIST condition later in Phase 5. 


FREE BLK COUNT WRONG IN SUPERBLOCK (FIX?) 

The actual count of free blocks does not match the count m 
the super-block ;<f the filesystem. 

BAD FREE LIST (SALVAGE?) 

This message is always preceded by one or more of the 
Phase 5 information messages. If the -q option is specified, 
the free-block list will be salvaged automatically. 

Phase 6: Salvage Free List ___ 

This phase reconstructs the free-block list. It has one possible error 
condition that results from bad blocks-per-cylinder and gap values. 


Phase 6 Error Messages 

DEFAULT FREE-BLOCK LIST SPACING ASSUMED 

This is an advisory message indicating the blocks-to-skip 
(gap) is greater than the blocks-per-cylinder, the blocks-to- 
skip is less than 1, the blocks-per-cylinder is less than 1, or 
the blocks-per-cylinder is greater than 500. The values of 7 
blocks-to-skip and 400 blocks-per-cylinder are used. 


Cleanup Phase 


Once a filesystem has been checked, a few cleanup functions are per¬ 
formed. The cleanup phase displays advisory messages about the 
filesystem and status of the filesystem. 


Cleanup Phase Messages 
X files Y blocks Z free 

This is an advisory message indicating that the filesystem 
checked contained X files using Y blocks leaving Z blocks 
free in the filesystem. 

He**** BOOT XENIX (NO SYNC!) ***** 
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This is an advisory message indicating that a mounted 
filesystem or the root filesystem has been modified by fsck. 
If the UNIX system is not rebooted immediately without 
sync, the work done by fsck may be undone by the in-core 
copies of tables the UNIX system keeps. If the -b option of 
the fsck command was specified and the filesystem is root, a 
reboot is automatically done. 

***** FILE SYSTEM WAS MODIFIED ***** 

This is an advisory message indicating that the current 
filesystem was modified by fsck. 
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fsdb_ 

filesystem debugger 

Syntax 

/etc/fsdb special [ - ] 

Description 

fsdb can be used to patch up a damaged filesystem after a crash. It has 
conversions to translate block and i-numbers into their corresponding 
disk addresses. Also included are mnemonic offsets to access dif¬ 
ferent parts of an i-node. These greatly simplify the process of 
correcting control block entries or descending the filesystem tree. 

fsdb contains several error-checking routines to verify i-node and 
block addresses. These can be disabled if necessary by invoking fsdb 
with the optional - argument or by the use of the O symbol, (fsdb 
reads the i-size and f-size entries from the superblock of the filesys¬ 
tem as the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be 
prefixed with a zero. During any assignment operation, numbers are 
checked for a possible truncation error due to a size mismatch 
between source and destination. 

fsdb reads a block at a time and will therefore work with raw as well 
as block I/O. A buffer management routine is used to retain commonly 
used blocks of data in order to reduce the number of read system calls. 
All assignment operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 


# 

absolute address 

i 

convert from i-number to i-node address 

b 

convert to block address 

d 

directory slot offset 

+,- 

address arithmetic 

q 

quit 

>,< 

save, restore an address 


numerical assignment 

=+ 

incremental assignment 

=> 

decremental assignment 

_ii 

character string assignment 

O 

error checking flip flop 
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P 

f 

B 

W 

D 


general print facilities 
file print facility 
byte mode 
word mode 
double word mode 
escape to shell 


The print facilities generate a formatted output in various styles. The 
current address is normalized to an appropriate boundary before print¬ 
ing begins. It advances with the printing and is left at the address of 
the last item printed. The output can be terminated at any time by typ¬ 
ing the delete character. If a number follows the p symbol, that many 
entries are printed. A check is made to detect block boundary 
overflows since logically sequential blocks are generally not physi¬ 
cally sequential. If a count of zero is used, all entries to the end of the 
current block are printed. The print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with the current 
i-node. If followed by a number, that block of the file is printed. 
(Blocks are numbered from zero.) The desired print option letter fol¬ 
lows the block number, if present, or the f symbol. This print facility 
works for small as well as large files. It checks for special devices and 
that the block pointers used to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but are not 
necessary. A line with just a new-line character will increment the 
current address by the size of the data type last printed. That is, the 
address is set to the next byte, word, double word, directory entry or 
i-node, allowing the user to step through a region of a filesystem. 
Information is printed in a format appropriate to the data type. Bytes, 
words and double words are displayed with the octal address followed 
by the value in octal and decimal. A .B or .D is appended to the 
address for byte and double word values, respectively. Directories are 
printed as a directory slot offset followed by the decimal i-number and 
the character representation of the entry name. I-nodes are printed 
with labeled fields describing each element. 

The following mnemonics are used for i-node examination and refer to 
the current working i-node: 

md mode 

In link count 

uid user ID number 
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gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 


Examples 


386i 

ln=4 


prints i-number 386 in an i-node format. This now 
becomes the current working i-node. 

changes the link count for the working i-node to 4. 


ln=+l 


increments the link count by 1. 


fc 


2i.fd 


d5i.fc 


512B.p0o 


prints, in ASCII, block zero of the file associated 
with the working i-node. 

prints the first 32 directory entries for the root i- 
node of this filesystem. 

changes the current i-node to that associated with 
the 5th directory entry (numbered from zero) 
found from the above command. The first logical 
block of the file is then printed in ASCII. 

prints the superblock of this filesystem in octal. 


2i.a0b.d7=3 changes the i-number for the seventh directory slot 

in the root directory to 3. This example also 
shows how several operations can be combined on 
one command line. 

d7.nm="name" changes the name field in the directory slot to the 
given string. Quotes are optional when used with 
nm if the first character is alphabetic. 

a2b.p0d prints the third block of the current i-node as 

directory entries. 


Notes 


The directory /etc/fscmd.d/TYPE contains programs for each filesys¬ 
tem type; each cf these programs applies some appropriate heuristic to 
determine whether the supplied special file is of the type for which it 
checks. 
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g*?™* dir f.]’ file system(F), “Patching a Filesystem with fsdb” 
Guide U 8 Fllesystems cha P ter of th ® System Administrator’s 
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fsname _ 

prints or changes the name of a file system 

Syntax 

fsname [-p] [-s name ] /dev /device 


Description__ 

The letc/fsname utility is used to print or change the name of a filesys¬ 
tem. The options are: 

-p Select the “pack” name field instead of the filesystem 

name field. 

-s name Changes the specified field in the superblock. 

The default action is to print the name of the filesystem. 


See Also____- 

mkfs(ADM), ustat(S), filesystem(F) 

Value Added ___ 

fsname is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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fsphoto _ 

performs periodic semi-automated system backups 

Syntax 


fsphoto [-i] schedule [ drive ] 

Description 


fsphoto, in conjunction with /save (ADM), provides a semi-automated 
interface to xhackup (ADM) and cpio(C) for backing-up filesystems 
(xbackup can only be used to back up XENIX fileystems). A human 
operator is required to mount and dismount tapes or floppies at the ap- 
propnate times, so some interaction is necessary, but all such interac¬ 
tion is kept to a minimum to reduce the potential for human error. 

TTie selection and timing of backups for all filesystems is governed by 
the schedule (ADM) database. The system administrator must set up 
ttus file, and make arrangements to run fsphoto on the implicitly 
defined schedule (normally once per weekday), fsphoto can be 
rnvoked most easily from the sysadmsh( ADM), fsphoto interprets 
schedule , and for each filesystem that should be backed-up on that 
day, runs fsave to interact with the operator and backup the filesystem 
without error. 

The optional argument drive specifies the magtape or floppy device to 
use; the default is specified in the schedule file. 

Backups may be postponed (via fsave) or interrupted. The resulting 
partial’ ’ backups are automatically resumed the next time fsphoto is 
run: Any missed filesystems are backed-up as if the original backup 
had not been delayed. The -i flag ignores any pending partial backups. 

If there is a pending partial backup, the normally scheduled backups 
are not done. This means that if a partial backup is resumed, and the 
normally scheduled backups are to be don fsphoto must be run twice. 

You must be the super-user to use this program. 

Files 


/ usrl lib!sysadmin!schedule 

Database describing which filesystems are to be backed-up when 
and at what dump level . 
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/dev/tty 

Source of interactive input. 


/usr/lib/sysadmin/past 

Record of filesystems 
tial backup. 


successfully backed-up in the pending par- 


Temporary file for recording successfully backed-up filesystems. 


See Also 

fsave(ADM), schedule(ADM), xbackup(ADM), basename(C) 

Diagnostics 

fsphoto complains of syntax errors in schedule , and exits with a status 
of 1. 

fsphoto complains about illegal or incorrect arguments, and exits with 
a status of 1. 

An interrupt will cause an exit status of 2. 

Notes 

If a drive is explicitly given, the “raw” (/dev/r*) form of the device 
should be used. 

Value Added ___ 

fsphoto is an extension to AT&T System V developed by the Santa 
Cruz Operation. 
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fsstat _ 

report file system status 

Syntax 


/etc/fsstat special_file 

Description 


The fsstat command reports on the status of the file system on 
special Jile . During startup, this command is used to determine if the 
file system needs checking before it is mounted. The fsstat command 
succeeds if the file system is unmounted and appears okay. For the 
root file system, it succeeds if the file system is active and not marked 
bad. 

See Also 


filesystem(F) 

Diagnostics 


The command has the following exit codes: 

0 the file system is not mounted and appears okay, (except for 
root where 0 means mounted and okay). 

1 the file system is not mounted and needs to be checked. 

2 the file system is mounted. 

3 the command failed. 


This command does not work on DOS filesystems. 

The directory /etc/fscmd.d/7Tf > £ contains programs for each file sys¬ 
tem type, fsstat invokes the appropriate binary. 
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fstyp__ 

determine file system identifier 

Syntax 

fstyp device 

Description 

The fstyp command allows the user to determine the file system iden¬ 
tifier of mounted or unmounted file systems using heuristic programs. 
The file system type is required by mount(S) and sometimes by 
mount( ADM) to mount file systems of different types. 

fstyp runs the programs in /etc/fscmd.d/7Y.PE in alphabetical order, 
passing device as an argument; if any program succeeds, its filesystem 
type identifier is printed and fstyp exits immediately. If no program 
succeeds, fstyp prints “Unknown_fstyp” to indicate failure. 

See Also 


mount(ADM), mount(S), sysfs(S) 
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fwtmp, wtmpfix _ 

manipulate connect accounting records 

Syntax 

/usr/Iib/acct/fwtmp [-ic] 

/usr/Iib/acct/wtmpfix [files] 

Description 


fwtmp 

fwtmp reads from the standard input and writes to the standard output, 
converting binary records of the type found in wtmp to formatted 5 
recor< ^ s * r ^ ie ASCII version is useful to enable editing, via 
ed ( C), bad records or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and 
output is to be written in binary form. 


wtmpfix 

wtmpfix examines the standard input or named files in wtmp format, 
corrects the time/date stamps to make the entries consistent, and 
writes to the standard output. A - can be used in place of files to indi¬ 
cate the standard input. If time/date corrections are not performed, 
acctcon(ADM) will fault when it encounters certain date-change 
records. 


Each time the date is set, a pair of date change records are written to 
/etc/wtmp. The first record is the old date denoted by the string old 
time placed m the line field and the flag OLD TIME placed in the 
type field of the <utmp.h> structure. The second record specifies the 
new date and is denoted by the string new time placed in the line field 
and the flag NEW_TIME placed in the type field, wtmpfix uses these 
records to synchronize all time stamps in the file. 

I",addition to correcting time/date stamps, wtmpfix will check the 
validity of the name field to ensure that it consists solely of 
alphanumeric characters or spaces. If it encounters a name that is 
considered invalid, it will change the login name to INVALID and 
write a diagnostic to the standard error. In this way, wtmpfix reduces 
the chance that acctcon(ADM) will fail when processing connect 
accounting records. 
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Files 


FWTMP (ADM) 


/etc/wtmp 


See Also 


acct(ADM), acctcms(ADM), acctcom(C) acctcon(ADM) 
acctmerg(ADM), acctprc(ADM), acctsh(ADM), ed(C), 
runacct(ADM), acct(S), acct(F), utmp(F) 


Standards Conformance 


fwtmp and wtmpfix are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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goodpw _ 

check a password for non-obviousness 


Syntax 

goodpw [ -absm ] [ -d file ] [ -r reason ] [ -MR expr ] 

Description 


goodpw reads from the standard input a proposed password and 
applies a variety of heuristic checks intended to spot poor password 
choices. These checks can include checking against user names, 
bnglish words, and too short or too simple passwords. Which checks 
are applied depends on the settings in /etc/default/goodpw, the file 
specified by the -d option, and the expressions specified by the -M 
and -R options. 


The first line read from the standard input is taken to be the proposed 
password. A list of “canonical forms” is then generated; the canoni¬ 
cal form is the password sans any non-letters and with all letters con¬ 
verted to upper-case. The list always includes the canonical form of 
the / _ password _ and may, depending on the settings in 
/etc/default/goodpw, also contain left or right “rotations” of the 
canonical form. A rotation to the left is a shifting of the second 
through last character one position to the left, with the first character 
becoming the last; a rotation to the right is similar but in the opposite 
direction. The canonical list so generated is what most of the checks 
are applied against; if any (possibly rotated) canonical form in the list 
tails a check, the password is considered inadvisable and is rejected 


Any subsequent lines read from the standard input are taken to be a 
stop-list” of disallowed passwords. Each line in the stop-list is 
reduced to its canonical form and checked against the canonical list; if 
there is a match, the password is rejected. 


When a password is rejected, the reason is written to the standard 
error output and goodpw exits with a non-zero status. If a password 
passes all checks and hence is not rejected, no message is issued and 
goodpw exits with a zero status. 


The -s and -m options modify this behavior: If -s is specified, no rea¬ 
son is issued. If -m is specified, then: 

1. the stop-list terminates with an empty line, 

2. one line is written to the standard output indicating the accep¬ 
tance or rejection of the password, and 
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3. the entire procedure is repeated using a new password and 
stop-list read from the standard input. 

This allows one goodpw process to check multiple passwords. The 
line written by goodpw to the standard output if -m is specified is one 
of: 

g The password passed all checks and seems to be acceptable. 
Treason 

The password was rejected for the indicated reason. 


The indicated system error occurred and it cannot be determined 
whether or not the password is acceptable. 

If -s was specified, then no reason or error is written after a “r” or 
“e,” respectively. 

The other options are: 

-a Use American spelling (default). 

-b Use British spelling. 


Specify the message to be issued in case the proposed password 
matches one of those in the stop-list. The default reason is same 
as previous password.” 


Read the named file (which should be in the same format as 
/etc/default/goodpw) and apply the various checks specified. 


The password must match expr, a boolean combination of regular 
expressions. If the first character of expr is a slash (“/’ ’) and a reg¬ 
ular file by that name exists, the contents of that file are used as the 
expression. (If the file cannot be read, an error results.) 

-R expr 

The password must not match expr. 

The boolean combination of regular expressions ( expr ) is built from 
the following operations: 


expr x & expr^ 

True if, and only if, both expressions expr { and expr 2 are true. If 
expr^ is not true, expr^ is not evaluated. 
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expr { | expr 2 

True if either (or both) of expr or expr is true. If expr, is true, 
ex P r 2 1S n °t evaluated. 12 1 

ex P r x ' expr 2 

True if exactly one of expr and expr are true. Both expr and 
expr 2 are always evaluated. 1 1 

! expr 

True if expr is not true; expr is always evaluated. 


( expr ) 

True if, and only if, expr is true; expr is always evaluated. 

I re I 

True if, and only if, regular expression re matches the password 
Any regular expression defined by regcmp( S) is understood; sut> 
strings defined by (...)$/* are placed in “accumulator” n. 

%n ~ Irel 

True if, and only if, accumulator n (0-9, or *) matches regular 
expression re; accumulator star (“*”) is the entire password. 


$n l" Irel 

True if, and only if, accumulator n is not matched by regular 
expression re. & 


The possible goodpw checks, their control settings 
/etc/default/goodpw, and default values are: 


in 


MATCH=Aisr/lib/goodpw/match 

An expression (expr ), or the name of file containing an expression 
that the password must match. This expression also may be 
specified by the -M option. 


REJECT=/usr/lib/goodpw/reject 

An expression, or the name of a file containing an expression, that 
the password must not match. This expression may also be 
specified by the -R option. 

LEFT_ROTATIONS=UNIQUE 

How left rotations of the canonical form of the password should be 
frfjted: NO - ignored; YES - considered in other checks (i.e., 

itxtt/Itti? canon ^ c ^ ^ st ) and may contain duplications; 
UNIQUE - considered in other checks but must not contain any 
duplicates. 

RIGHT_ROTATIONS=UNIQUE 
Similarly for right rotations. 
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BOTH_ROTATIONS=UNIQUE 

Similarly for rotations in both directions taken together. 


AV OID_USERS=YES , . , 

Should the canonical list be checked agamst user login names and 
real names, obtained from /etc/passwd? 

AVOID_GROUPS=YES , 

Should the canonical list be checked agamst group names and 
group member lists, obtained from /etc/group? 

AVOID_MACHINES=YES 

Should the canonical list be checked agamst machine names 
obtained from a number of files, including /etc/systemid and 
/usr/lib/mail/top ? 

AV OID_ALIASES=YES , . , 

Should the canonical list be checked against mail aliases obtained 

from /usr/lib/mail/aliases? 


AVOID_WORDS=YES 

Should the canonical list be checked for properly spelled English 
words? 


BRITISH=NO , „ 

Should spell use American or British spelling / 
use may be specified by the -a and -b options. 


Which spelling to 


SITECHECKS=NO , , ,. 

The name of a program to ran to provide additional checking, ine 
program is ran with no arguments. Passed to the program on its 
standard input, on separate lines, is first the actual proposed pass¬ 
word and then the canonical list. If the program exits with a non¬ 
zero status, the password is rejected. 


SITEREASON=Rejected by site-specific check(s) 

The reason to give when the SITECHECKS program rejects the 
password. 


The values for the default settings can be adjusted to reflect the local 
system’s security concerns. If /etc/default/goodpw does not exist or 
cannot be read, the above default values are used (except tor MAI Ul 
and REJECT). The default MATCH expression matches any pass- 
word which: 


1. Contains lower-case letters, upper-case letters, and digits, and 
whose length is four or more characters; or, 

2. Contains no lower-case letters, no upper-case letters, and no digits, 
and whose length is four or more characters; or, 
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3. Contains both lower-case letters and digits, or both upper-case 
letters and digits, or both lower- and upper-case letters, and whose 
length is five or more characters; or, 

4. Contains nothing but lower-case letters, and whose length is six or 
more characters; or, 

5. Contains nothing but upper-case latters, and whose length is six or 
more characters. 

The default REJECT expression is: 

/[Ss][Cc][Oo]/1 /[Xx] [Ee] [Nn] [Ii] [Xx]/ 

which matches any password that contains either “SCO” or 

“XENIX” regardless of case. 


Files 


/usr/lib/goodpw/match 

Expression that all passwords must match; by default, it contains 
the above-described MATCH expression. 


/usr/lib/goodp w/reject 

Expression that no passwords should match; by default, it contains 
the above-described REJECT expression. 


See Also 


alia ^(M), default(M), group(M), passwd(C), passwd(M), regex(S), 
spell(CT), systemid(M) 6 w * 

Notes 


Not all valid English words are known to spell, and hence some 
English words are considered acceptable as passwords. 

The maximum length of a password is 100 characters, none of which 
may be an ASCII NUL or LF (newline). 

Empty passwords are always rejected. 


Value Added 


goodpw is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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graph 


draws a graph 


Syntax 

- 

graph [ options ] 


Description 



The graph command with no options takes pairs of numbers from the 
standard input as abscissas and ordinates of a graph. Successive 
points are connected by straight lines. The graph is encoded on the 
standard output for display by the tplot ( ADM) filters. 


If the coordinates of a point are followed by a non-numeric string, that 
string is printed as a label beginning on the point. Labels may be sur¬ 
rounded with quotes ", in which case they may be empty or contain 
blanks and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

. a Supply abscissas automatically (they are missing from the 

input); spacing is given by the next argument (default 1). 
A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by -x). 
-b Break (disconnect) the graph after each label in the input, 

-c Character string given by next argument is default label 

for each point. 

-g Next argument is grid style, 0 no grid, 1 frame with ticks, 

2 full grid (default). 

-1 Next argument is label for graph. 

-m Next argument is mode (style) of connecting lines: 0 

disconnected, 1 connected (default). Some devices give 
distinguishable line styles for other small integers (e.g., 
the Tektronix 4014: 2=dotted, 3=dash-dot, 4=short-dash, 
5=long-dash). 

Save screen, do not erase before plotting. 

-x T 1] If I is present, x axis is logarithmic. Next 1 (or 2) argu¬ 
ments are lower (and upper) x limits. Third argument, if 
present, is grid spacing on x axis. Normally these quanti¬ 
ties are determined automatically. 

-y [ 1 ] Similarly for y. . 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

_ r Next argument is fraction of space to move right before 

plotting. 
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-u Similarly to move up before plotting. 

•t Transpose horizontal and vertical axes. (Option -x now 

applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the -s 
option is present. If a specified lower limit exceeds the upper limit 
the axis is reversed. 

See Also 


graphics(ADM), tplot(ADM), spline(C) 

Notes 


The graph command stores all points internally and drops those for 
which there is no room. 

Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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haltsys, reboot __ 

closes out the file systems and shuts down the system 


Syntax 

/etc/haltsys [ -d ] 
/etc/reboot 

Description 


The haltsys utility performs a uadmin( ) system call (see uadmin( S)) to 
flush out pending disk I/O, mark the file systems clean, and halt the 
processor, haltsys takes effect immediately, so user processes should 
be killed beforehand, shutdown^ ADM) is recommended for normal 
system shutdown, since it warns users, terminates processes, then calls 
haltsys. Use haltsys directly only if you cannot run shutdown; for 
example, because of some system problem. 

haltsys displays a prompt indicating that the system has been shut 
down and can be rebooted or powered down. If the -d option is used, 
the system will remain down and you are not given the option to 
reboot. 

The reboot command performs the same function as haltsys, except 
the system is rebooted automatically afterwards. 

Only the super-user can execute haltsys or reboot. 


Notes 

haltsys locks hard disk heads. 

See Also 

shutdn(S), uadmin(S), shutdown(ADM) 

reboot was developed at the University of California, Berkeley, and is 
used with permission. 

Value Added 


haltsys and reboot are extensions of AT&T System V provided by the 
Santa Cruz Operation. 
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id 

print user and group IDs and names 

Syntax 

id 

Description 


The id command outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real IDs are dif¬ 
ferent, both are printed. 

See Also 


logname(C), getuid(S) 

Standards Conformance 


id is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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idaddld 

add or remove line disciplines from kernel configura¬ 
tion files 

Syntax 

/etc/conf/bin/idaddld [-a name routine 1 ... routine8] [-de name] 

Description 


idaddld is used to add or remove line discipline declarations from ker¬ 
nel configuration files. If no arguments are given then idaddld enters 
an interactive mode. In this mode the user can add, delete or view the 
current configuration. If a change is specified then the user is 
prompted to relink the kernel. If arguments are given on the command 
line then idaddld enters a non-interactive mode executing the speci¬ 
fied command silently. It is the responsibility of the calling program 
to insure the kernel is relinked to effect the desired changes. 

Options 

The following options are available from the command line. 

-a prefix routine 1 ... routine8 

Add a line discipline to configuration files. Prefix is a tag used to 
identify the line discipline for future inquiries or removal. For 
example, the terminal line discipline uses the prefix tty. Routine 1 
through routine8 define the list of line discipline routines. There 
must be eight routines with the keyword "nulldev" used as a place¬ 
holder. The order of the routines is critical. They must be ordered 
as follows: 

open close read write ioctl rxint txint modemint 
-d prefix 

Remove the line discipline whose identifier matches prefix. 

-c prefix 

Scan the line discipline switch table for an entry which matches 
prefix. The program will exit with a return status 0 if a match is 
found and 1 otherwise. 
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Notes 


When a line discipline is added, it is appended to the current switch 
table configuration. 

Value Added 


idaddld is an extension of AT&T System V provided by The Santa 
Cruz Operation, Inc. 
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idbuild, idmkenv, idmkunix, idconfig, 
idvidi, idscsi 

build new UNIX system kernel 

Syntax 

/etc/conf/bin/idbuiid 

Description 


This script builds a new UNIX system kernel using the current system 
configuration in /etc/conf. Kernel reconfigurations are usually done 
after a device driver is installed, or system tunable parameters are 
modified. The script uses the shell variable $ROOT from the user’s 
environment as its starting path. Except for the special case of kernel 
development in a non-root source tree, the shell variable ROOT 
should always be set to null or to “A” idbuild exits with a return code 
of zero on success and non-zero on failure. 

Building a new UNIX system image consists of generating new sys¬ 
tem configuration files, then link-editing the kernel and device driver 
object modules in the /etc/conf/pack.d object tree. This is done by 
idbuild by calling the following commands: 

/etc/corf/bin/idconfig To build kernel configuration files. 

!etc/conf/bin! idmkunix To process the configuration files and link-edit 
a new UNIX system image. 

The system configuration files are built by processing the Master and 
System files representing device driver and tunable parameter specifi¬ 
cations. The files /etc/conf/cf.d/mdevice, and /etc/conf/cf.d/mtune 
represent the Master information. The file /etc/conf/cf.d/stune, and 
the files specified in /etc/conf/sdevice.d/* represent the System infor¬ 
mation. The kernel also has file system type information defined in 
the files specified by /etc/conf/sfsys.d/* and /etc/conf/mfsys.d/*. 

idvidi and idscsi read the video driver and SCSI driver configurations, 
respectively. 

idconfig reads the system configuration files and reports any conflicts 
and errors. 

idmkunix links the necessary modules to create the new kernel. 
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Once a new UNIX system kernel has been configured and linked, 
idmkdenv is invoked to back up the current /unix and replace it with 
the new kernel, and rebuild the kernel environment. 

Diagnostics 


Since idbuild calls other system commands to accomplish system 
reconfiguration and link editing, it will report all errors encountered 
by those commands, then clean up intermediate files created in the 
process. In general, the exit value 1 indicates an error was encoun¬ 
tered by idbuild. 

The errors encountered fall into the following categories: 

Master file error messages. 

System file error messages. 

Tunable file error messages. 

Compiler and Link-editor error messages. 

All error messages are designed to be self-explanatory. 

See Also 


configure(ADM), idinstall(ADM), idtune(ADM), mdevice(F), 
mfsys(F), mtune(F), sdevice(F), sfsys(F), stune(F) 
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idcheck__ 

returns selected information 

Syntax 

/etc/conf/bin/idcheck 

Description 

This command returns selected information about the system configu¬ 
ration. It is useful in add-on device Driver Software Package (DSP) 
installation scripts to determine if a particular device driver has 
already been installed, or to verify that a particular interrupt vector, 
I/O address or other selectable parameter is in fact available for use. 
The various forms are: 

idcheck -p device-name [-i dir] [-r] 

idcheck -v vector [-i dir] [-r] 

idcheck -d dma-channel [-i dir] [-r] 

idcheck -a -1 lower_address -u upper_address [-i dir] [-r] 

idcheck -c -1 lower_address -u upper_address [-i dir] [-r] 

This command scans the System and Master modules and returns: 

100 if an error occurs. 

0 if no conflict exists. 

a positive number greater than 0 and less than 100 if a conflict 
exists. 

The command line options are: 

. r Report device name of any conflicting device on 

stdout. 

-p device-name This option checks for the existence of four different 
components of the DSP. The exit code is the addi¬ 
tion of the return codes from the four checks. 

Add 1 to the exit code if the DSP directory under 
/etc/conf/pack.d exists. 

Add 2 to the exit code if the Master module has been 
installed. 

Add 4 to the exit code if the System module has been 
installed. 
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Add 8 to the exit code if the Kernel was built with 
the System module. 

Add 16 to the exit code if a Driver.o is part of the 
DSP (vs. a stubs.c file). 


-v vector Returns “type” field of device that is using the vec¬ 

tor specified (i.e., another DSP is already using the 
vector). 

-d dma-channel Returns 1 if the dma channel specified is being used. 

' a This option checks whether the IOA region bounded 

by “lower” and “upper” conflict with another DSP 
(“lower” and “upper” are specified with the -1 and 
-it options). The exit code is the addition of two 
different return codes. 

Add 1 to the exit code if the IOA region overlaps 
with another device. 

Add 2 to the exit code if the IOA region overlaps 
with another device and that device has the ’O’ 
option specified in the type field of the Master 
module. The ’O’ option permits a driver to overlap 
the IOA region of another driver. 


-c 


•1 address 


■u address 


■i dir 


Returns 1 if the CMA region bounded by "lower" and 
"upper" conflict with another DSP ("lower" and 
"upper" are specified with the -1 and -u options). 

Lower bound of address range specified in hex. The 
leading Ox is unnecessary. 

Upper bound of address range specified in hex. The 
leading Ox is unnecessary. 

Specifies the directory in which the ID files sdevice 
and mdevice reside. The default directory is 

/etc/conf/cf.d. 


Diagnostics 


There are no error messages or checks for valid arguments to options. 
idcheck interprets these arguments using the rules of scanf( S) and 
queries the sdevice and mdevice files. For example, if a letter is used 
in the place of a digit, scanf{ S) will translate the letter to 0. idcheck 
will then use this value in its query. 


See Also 


idinstall(ADM), mdevice(F), sdevice(F) 
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idinstall __ 

add, delete, update, or get device driver configuration 

data 

Syntax 

/etc/conf/bin/idinstall [adug] [-e] -[ msoptnirhcl ] dev_name 


Description 

The idinstall command is called by a Driver Software Package (DSP) 
Install script or Remove script to Add (-a), Delete (-d), Update (-u), or 
Get (-g) device driver configuration data, idinstall expects to find 
driver component files in the current directory. When components are 
installed or updated, they are moved or appended to files in the 
/etc/conf directory and then deleted from the current directory unless 
the -k flag is used. The options for the command are as follows: 

Action Specifiers: 

-a Add the DSP components 

-d Remove the DSP components 

-u Update the DSP components 

-g Get the DSP components (print to std out, except Master) 
Component Specifiers: (*) 

-m Master component 

-s System component 

-o Driver.o component 

-p Space.c component 

-t Stubs.c component 

-n Node (special file) component 

-i Inittab component 

-r Device Initialization (rc) component 
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-h Device shutdown (sd) component 

-c Mfsys component: file system type config (Master) data 

-1 Sfsys component: file system type local (System) data 

(*) If no component is specified, the default is all except 
tor the -g option where a single component must be 
specified explicitly. 

Miscellaneous: 


-e Disable free disk space check 

-k Keep files (do not remove from current directory) on add or 
update. 


In die simplest case of installing a new DSP, the command syntax 
used by the DSP’s Install dinstascript should be idinstall -a dev name. 
In this case the command will require and install a Driver.o, Master 
and System entry, and optionally install the Space.c, Stubs.c, Node, 
Imt, Rc, Shutdown, Mfsys, and Sfsys components if those modules are 
present m the current directory. 


The Driver. 0 , Space.c, and Stubs.c files are moved to a directory in 
/etc/conf/pack.d. The devjiame is passed as an argument, which is 
used as the directory name. The remaining components are stored in 
the corresponding directories under /etc/conf in a file whose name is 
dev name. For example, the Node file would be moved to 
/etc/conf/node.d/dev name. 


The idinstall -m usage provides an interface to the idmaster command 
which will add, delete, and update mdevice file entries using a Master 
file from the local directory. An interface is provided here so that 
driver writers have a consistent interface to install any DSP com¬ 
ponent. 


As stated above, driver writers will generally use only the idinstall -a 
dev name form of the command. Other options of idinstall are pro- 
vided to allow an Update DSP (i.e., one that replaces an existing de- 
vice driver component) to be installed, and to support installation of 
multiple controller boards of the same type. 

If the call to idinstall uses the -u (update) option, it will: 

overlay the files of the old DSP with the files of the new DSP. 

invoke the idmaster command with the ’update’ option if a Mas¬ 
ter module is part of the new DSP. 


idinstall also does a verification that enough free disk space is avail¬ 
able to start the reconfiguration process. This is done by calling the 
idspace command, idinstall will fail if insufficient space exists, and 
exit with a non-zero return code. The -e option bypasses this check. 
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idinstall makes a record of the last device installed in a file 
(/etc/.last dev add), and saves all removed files from the last delete 
operation "in a directory (/etc/.last_dev_del). These files are recovered 
by letclconf/bin/idmkenv whenever it is determined that a system 
reconfiguration was aborted due to a power failure or unexpected sys¬ 
tem reboot. 


Diagnostics 


An exit value of zero indicates success. If an error was encountered, 
idinstall will exit with a non-zero value, and report an error message. 
All error messages are designed to be self-explanatory. Typical error 
message that can be generated by idinstall are as follows: 

Device package already exists. 

Cannot make the driver package directory. 

Cannot remove driver package directory. 

Local directory does not contain a Driver object (Driver,o) pie. 
Local directory does not contain a Master file. 

Local directory does not contain a System file. 

Cannot remove driver entry. 


See Also 

idspace(ADM), idcheck(ADM), mdevice(F), sdevice(F) 
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idleout 

logs out idle users 


Syntax 


idleout [ minutes I hours:minutes ] 

Description 


The idleout command monitors line activity and logs out users whose 
terminal remains idle longer than a specified period of time. Minutes 
are assumed; if a colon appears in the number, hours are assumed. 

The utility uses a default file, letcldefaultlidleout, to indicate the num¬ 
ber of hours a user’s terminal may remain idle before being logged 
out. This file has one entry: 

IDLETIME=rime 

The time format is identical to that used on the command line The 
time specified in the default file is overridden by idletime if idletime 
is specified on the command line. Note that, if idletime is zero, no 
monitoring takes place and idle users are not logged out. You can 
either run idleout ffrom the command line, or, to have continuous cov¬ 
erage, you must add the program name in /etc/rc.d/8/userdef to see to 
it that the program is run each time the system is rebooted. 

Files 


/etc/default/idleout 

/etc/utmp 

/etc/wtmp 

See Also 


who(C), getut(S), kill(S) 

Value Added 


idleout is an extension of AT&T System V provided by the Santa Cruz 
Operation. 


March 15, 1989 


IDLEOUT-1 














IDMKINIT (ADM) 


IDMKINIT (ADM) 


idmkinit 


read files containing specifications 


Syntax 


/etc/conf/bin/idmkinit 


Description 



This command reads the files containing specifications of /etc/inittab 
entries from /etc/conf/init.d and constructs a new inittab file in 
/etc/conf/cf.d. It returns 0 on success and a positive number on error. 


The files in /etc/conf/init.d are copies of the Init modules in device 
Driver Software Packages (DSP). There is at most one Init file per 
DSP. Each file contains one line for each inittab entry to be installed. 
There may be multiple lines (i.e., multiple inittab entries) per file. An 
inittab entry has the form (the id field is often called the tag): 

id:rstate:action:process 

The Init module entry must have one of the following forms: 

action:process 

rstate:action:process 

id:rstate:action:process 

When idmkinit encounters an entry of the first type, a valid id field 
will be generated, and an rstate field of 2 (indicating run on mit 
state 2) will be generated. When an entry of the second type is 
encountered, only the id field is prefixed. An entry of the third type is 
incorporated into the new inittab unchanged. 

Since add-on inittab entries specify init state 2 for their rstate field 
most often, an entry of the first type should almost always be used. 
An entry of the second type may be specified if you need to specify 
other than state 2. DSP’s should avoid specifying the id field as in the 
third entry since other add-on applications or DSPs may have already 
used the id value you have chosen. The /etc/init program will 
encounter serious errors if one or more inittab entries contain the 
same id field. 

idmkinit determines which of the three forms above is being used for 
the entry by requiring each entry to have a valid action keyword. 
Valid action values are as follows: 
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off 

respawn 

ondemand 

once 

wait 

boot 

bootwait 

powerfail 

powerwait 

initdefault 

sysinit 

The idmkinit command is called automatically upon entering init 
state 2 on the next system reboot after a kernel reconfiguration to 
establish the correct /etc/inittab for the running /unix kernel, idmkinit 
can be called as a user level command to test modification of inittab 
before a DSP is actually built. It is also useful in installation scripts 
that do not reconfigure the kernel but need to create inittab entries. In 
this case, the inittab generated by idmkinit must be copied to 
/etc/inittab, and a telinitq command must be run to make the new 
entry take effect. 

The command line options are 

-o directory inittab will be created in the directory specified rather 
than /etc/conf/cf.d. 

-i directory The ID file init.base, which normally resides in 
/etc/conf/cf.d, can be found in the directory specified. 

-e directory The Init modules that are usually in /etc/conf/init.d can 
be found in the directory specified. 

-# Print debugging information. 

Diagnostics 


An exit value of zero indicates success. If an error was encountered, 
idmkinit will exit with a non-zero value and report an error message 
All error messages are designed to be self-explanatoiy. 


See Also 


idbuild(ADM), idinstall(ADM), idmknod(ADM), init(M), inittab(F) 
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idmknod ___._ 

removes nodes and reads specifications of nodes 


Syntax 


/etc/conf/bin/idmknod 


Description ___ 

This command performs the following functions: 

• Removes the nodes for non-required devices (those that do not 
have an ‘r’ in field 3 of the device’s mdevice entry) from /dev. 
Ordinary files will not be removed. If the /dev directory con¬ 
tains subdirectories, those subdirectories will be transversed 
and nodes found for non-required devices will be removed as 
well. If empty subdirectories result due to the removal of 
nodes, the subdirectories are then removed. 


Reads the specifications of nodes given in the files contained in 
/etc/conf/node.d and installs these nodes in /dev. If the node 
specification defines a path containing subdirectories, the sub¬ 
directories will be made automatically. 

Returns 0 on success and a positive number on error. 


The idmknod command is run automatically upon entering imt state 2 
on the next system reboot after a kernel reconfiguration to establish 
the correct representation of device nodes in the /dev directory for the 
running /unix kernel, idmknod can be called as a user level command 
to test modification of the /dev directory before a DSP is actually 
built. It is also useful in installation scripts that do not reconfigure the 
kernel, but need to create /dev entries. 


The files in /etc/conf/node.d are copies of the Node modules installed 
by device Driver Software Packages (DSP). There is at most one file 
per DSP. Each file contains one line for each node that is to be 
installed. The format of each line is: 


Name of device entry (field 1) in the mdevice file (The mdevice 
entry will be the line installed by the DSP from its Master 
module). This field must be from 1 to 8 characters m length. The 
first character must be a letter. The others may be letters, digits, or 
underscores. 

Name of node to be inserted in /dev. The first character must be a 
letter. The others may be letters, digits, or underscores. This field 
can be a path relative to /dev, and idmknod will create subdirec¬ 
tories as needed. 
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The character b or c. A b indicates that the node is a ‘block’ type 
device and c indicates ‘character’ type device. 

Minor device number. This value must be between 0 and 255. If 
this field is a non-numeric, it is assumed to be a request for a 
streams clone device node, and idmknod will set the minor number 
to the value of the major number of the device specified. 

Some example node file entries are as follows: 

asy ttyOO c 1 

makes /dev/ttyOO for device ‘asy’ using minor device 1. 

qt rmt/cOsO c 4 

makes /dev/rmt/cOsO for device ‘qt’ using minor device 4. 

clone net/nau/clone c nau 

makes /dev/net/nau/clone for device ‘clone’. The minor device 
number is set to the major device number of device ‘nau’. 

The command line options are: 

-o directory Nodes will be installed in the directory specified rather 
than /dev. 

-i directory The file mdevice which normally resides in 

/etc/conf/cf.d, can be found in the directory specified. 

-e directory The Node modules that normally reside in 

/etc/conf/node.d can be found in the directory specified. 

-s Suppress removing nodes (just add new nodes). 

Diagnostics 


An exit value of zero indicates success. If an error was encountered 
due to a syntax or format error in a node entry, an advisory message 
will be printed to stdout and the command will continue. If a serious 
error is encountered (i.e., a required file cannot be found), idmknod 
will exit with a non-zero value and report an error message. All error 
messages are designed to be self-explanatory. 

See Also 


idinstall(ADM), idmkinit(ADM), mdevice(F), sdevice(F) 
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idspace _ 

investigates free space 

Syntax 


/etc/conf/bin/idspace [ -i inodes ] [ -r blocks ] [ -u blocks ] 

[ -t blocks ] 

Description 

This command investigates free space in /, /usr, and /tmp filesystems 
to determine whether sufficient disk blocks and inodes exist in each of 
potentially 3 filesystems. The default tests that idspace performs are 
as follows: 

• Verify that the root filesystem (/) has 400 blocks more than the 
size of the current /unix. This verifies that a device driver 
being added to the current /unix can be built and placed in the 
root directory. A check is also made to insure that 100 inodes 
exist in the root directory. 

• Determine whether a /usr filesystem exists. If it does exist, a 
test is made that 400 free blocks and 100 inodes are available in 
that filesystem. If the filesystem does not exist, idspace does 
not complain since files created in /usr by the reconfiguration 
process will be created in the root filesystem and space require¬ 
ments are covered by the test above. 

• Determine whether a /tmp filesystem exists. If it does exist, a 
test is made that 400 free blocks and 100 inodes are available in 
that filesystem. If the filesystem does not exist, idspace does 
not complain since files created in /tmp by the reconfiguration 
process will be created in the root filesystem and space require¬ 
ments are covered by the test above. 

The command line options are: 

-i inodes This option overrides the default test for 100 inode in all of 
the idspace checks. 

-r blocks This option overrides the default test for /unix size + 400 
blocks when checking the root (/) filesystem. When the -r 
option is used, the /usr and /tmp filesystems are not tested 
unless explicitly specified. 

-u blocks This option overrides the default test for 400 blocks when 
checking the /usr filesystem. When the -u option is used, 
the root (/) and /tmp filesystems are not tested unless 
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explicitly specified. If /usr is not a separate filesystem, an 
error is reported. 

-t blocks This option overrides the default test for 400 blocks when 
checking the /tmp filesystem. When the -t option is used, 
the root (/) and /usr filesystems are not tested unless expli¬ 
citly specified. If /tmp is not a separate filesystem, an error 
is reported. 

Diagnostics 


An exit value of zero indicates success. If insufficient space exists in a 
filesystem or an error was encountered due to a syntax or format error, 
idspace will report a message. All error messages are designed to be 
self-explanatory. The specific exit values are as follows: 

0 success. 

1 command syntax error, or needed file does not exist. 

2 filesystem has insufficient space or inodes. 

3 requested filesystem does not exist (-u and -t options only). 

See Also 


idbuild(ADM), idinstall(ADM) 


March 15,1989 


IDSPACE-2 









IDTUNE (ADM) 


IDTUNE (ADM) 


idtune __ 

attempts to set value of a tunable parameter 

Syntax 

/etc/conf/bin/idtune [-fl-m] name value 

Description 

This script attempts to set the value of a tunable parameter. The tun¬ 
able parameter to be changed is indicated by name. The desired value 
for the tunable parameter is value. 

If there is already a value for this parameter (in the stune file), the 
user will normally be asked to confirm the change with the following 
message: 

Tunable Parameter name is currently set to old_value. 
Is it OK to change it to value'? (y/n) 

If the user answers y, the change will be made. Otherwise, the tunable 
parameter will not be changed, and the following message will be dis¬ 
played: 

name left at old_value . 

However, if the -f (force) option is used, the change will always be 
made and no messages will ever be given. 

If the -m (minimum) option is used and there is an existing value 
which is greater than the desired value, no change will be made and no 
message will be given. 

If system tunable parameters are being modified as part of a device 
driver or application add-on package, it may not be desirable to 
prompt the user with the above question. The add-on package Install 
script may chose to override the existing value using the -f or -m 
options. However, care must be taken not to invalidate a tunable 
parameter modified earlier by the user or another add-on package. 

In order for the change in parameter to become effective, the UNIX 
system kernel must be rebuilt and the system rebooted. 
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The exit status will ne non-zero if errors are encountered. 

See Also 


idbuild(ADM), mtune(F), stune(F) 
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infocmp ___ 

compare or print out terminfo descriptions 

Syntax 

infocmp [-d] [-c] [-n] [-1] [-L] [-C] [-r] [-u] [-s d|i|l|c] [-v] [-V] [-1] 
[-w width] [-A directory] [-B directory] [termname ...] 

Description 

The infocmp command can be used to compare a binary terminfo (F) 
entry with other terminfo entries, rewrite a terminfo (F) description to 
take advantage of the use= terminfo field, or print out a terminfo ( F) 
description from the binary file [term(F)] in a variety of formats. In 
all cases, the Boolean fields will be printed first, followed by the 
numeric fields, followed by the string fields. 


Default Options 

If no options are specified and zero or one termnames are specified, 
the -I option will be assumed. If more than one termname is specified, 
the -d option will be assumed. 


Comparison Options [-d] [-c] [-n] 

The infocmp command compares the terminfo (F) description of the 
first terminal termname with each of the descriptions given by the 
entries for the other terminal’s termnames. If a capability is defined 
for only one of the terminals, the value returned will depend on the 
type of the capability! F for boolean variables, "1 for integer vari¬ 
ables, and NULL for string variables. 

-d produce a list of each capability that is different. In this 

manner, if one has two entries for the same terminal or simi¬ 
lar terminals, using infocmp will show what is different 
between the two entries. This is sometimes necessary when 
more than one person produces an entry for the same termi¬ 
nal and one wants to see what is different between the two. 

-c produce a list of each capability that is common between the 

two entries. Capabilities that are not set are ignored. This 
option can be used as a quick check to see if the -u option is 
worth using. 
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produce a list of each capability that is in neither entry. If 
no termnames are given, the environment variable TERM 
will be used for both of the termnames. This can be used as 
a quick check to see if anything was left out of the descrip¬ 
tion. 


Source Listing Options [-1] [-L] [-C] [-r] 

The -I, -L, and -C options will produce a source listing for each termi¬ 
nal named. 

-I use the terminfo( F) names 

-L use the long C variable name listed in <term.h> 

-C use the termcap names 

" r when using -C, put out all capabilities in termcap form 

If no termnames are given, the environment variable TERM will be 
used for the terminal name. 

The source produced by the -C option may be used directly as a 
termcap entry, but not all of the parameterized strings may be changed 
to the termcap format, infocmp will attempt to convert most of the 
parameterized information, but that which it doesn’t will be plainly 
marked in the output and commented out. These should be edited by 
hand. 

All padding information for strings will be collected together and 
placed at the beginning of the string where termcap expects it. Man¬ 
datory padding (padding information with a trailing ’/’) will become 
optional. 

All termcap variables no longer supported by terminfo(F), but which 
are derivable from other terminfo( F) variables, will be output. Not all 
terminfo(F) capabilities will be translated; only those variables which 
were part of termcap will normally be output. Specifying the -r 
option will take off this restriction, allowing all capabilities to be out¬ 
put in termcap form. 

Note that because padding is collected to the beginning of the capabil¬ 
ity, not all capabilities are output, mandatory padding is not supported, 
and termcap strings were not as flexible; it is not always possible to 
convert a terminfo{ F) string capability into an equivalent termcap for¬ 
mat. Not all of these strings will be able to be converted. A subse¬ 
quent conversion of the termcap file back into terminfo( F) format will 
not necessarily reproduce the original terminfo(F) source. 


March 15, 1989 


INFOCMP-2 







INFOCMP (ADM) 


INFOCMP (ADM) 


Some common terminfo parameter sequences, their termcap 
equivalents, and some terminal types which commonly have such 
sequences are: 


Terminfo 

%pl%c 

%pl%d 

%pl%’x’%+%c 

%i 

%p 1 %? % ’ x’ %>%t%p 1 % ’ y ’ %+%; 
%p2 is printed before %pl 


Termcap 

Representative Terminals 

%. 

adm 

%d 

hp, ANSI standard, vtlOO 

%+x 

concept 

%i 

ANSI standard, vtlOO 

%>xy 

concept 

%r 

hp 


Use= Option [-u] 

-u produce a terminfo (F) source description of the first terminal 

termname which is relative to the sum of the descriptions 
given by the entries for the other terminals’ termnames. It 
does this by analyzing the differences between the Gist term- 
name and the other termnames and producing a description 
with use= fields for the other terminals. In this manner, it is 
possible to retrofit generic terminfo entries into a terminal’s 
description. Or, if two similar terminals exist, but were 
coded at different times or by different people so that each 
description is a full description, using infocmp will show 
what can be done to change one description to be relative to 
the other. 

A capability will get printed with an at-sign (@) if it no longer exists 
in the first termname , but one of the other termname entries contains a 
value for it. A capability’s value gets printed if the value in the first 
termname is not found in any of the other termname entries, or if the 
first of the other termname entries that has this capability gives a 
different value for the capability than that in the first termname . 

The order of the other termname entries is significant. Since the 
terminfo compiler tic(C ) does a left-to-right scan of the capabilities, 
specifying two use= entries that contain differing entries for the same 
capabilities will produce different results depending on the order that 
the entries are given, infocmp will flag any such inconsistencies 
between the other termname entries as they are found. 

Alternatively, specifying a capability after a use= entry that contains 
that capability will cause the second specification to be ignored. 
Using infocmp to recreate a description can be a useful check to make 
sure that everything was specified correctly in the original source 
description. 

Another error that does not cause incorrect compiled files, but will 
slow down the compilation time, is specifying extra use= fields that 
are superfluous, infocmp will flag any other termname use= fields that 
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Other Options [-s d|i|l|c] [-v] [-V] [-1] [-w width] 

-s sort the fields within each type according to the argument 

below: 

d leave fields in the order that they are stored in the 
terminfo data base. 

i sort by terminfo name. 

1 sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be sorted 
alphabetically by the terminfo name within each type, 
except in the case of the -C or the -L options, which cause 
the sorting to be done by the termcap name or the long C 
variable name, respectively. 

-v print out tracing information on standard error as the pro¬ 
gram runs. 

-V print out the version of the program in use on standard error 
and exit. 

■1 cause the fields to print out one to a line. Otherwise, the 

fields will be printed several to a line to a maximum width 
of 60 characters. 

■w change the output to width characters. 


Changing Data Bases [-A directory] [-B directory] 

The location of the compiled terminfo(¥) data base is taken from the 
environment variable TERMINFO. If the variable is not defined or the 
terminal is not found in that location, the system terminfo( F) data 
base, usually in /usr/lib/terminfo, will be used. The options -A and 
-B may be used to override this location. The -A option will set TER¬ 
MINFO for the first termname and the -B option will set TERMINFO 
for the other termnames. With this, it is possible to compare descrip¬ 
tions for a terminal with the same name located in two different data 
bases. This is useful for comparing descriptions for the same terminal 
created by different people. Otherwise the terminals would have to be 
named differently in the terminfo( F) data base for a comparison to be 
made. 
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Files 


Aisr/lib/terminfo/? /* compiled terminal description data 

base 

Diagnostics 


malloc is out of space! 

There was not enough memory available to process all 
the terminal descriptions requested. Run infocmp 
several times, each time including a subset of the desired 
termnames. 

use- order dependency found: 

A value specified in one relative terminal specification 
was different from that in another relative terminal spe¬ 
cification. 

'use-term did not add anything to the description Jfl 

A relative terminal name did not contribute anything to 
the final description. 


must have at least Wo terminal names for a comparison to be done.Jfl 
The -u, -d, and -c options require at least two terminal 
names. 


See Also 


captoinfo(ADM), tic(C), curses(S), term(F), terminfo(F) 
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install 

install commands 

Syntax 

/etc/install [-c dira] [-f dirb] [-i] [-n dire] [-m mode] [-u user] 
[-g group] [-o] [-s] file [dirx ...] 

Description 


The install command is most commonly used in “makefiles” [see 
make( CP)] to install a file (updated target file) in a specific place 
within a file system. Each file is installed by copying it into the 
appropriate directory, thereby retaining the mode and owner of the 
original command. The program prints messages telling the user 
exactly what files it is replacing or creating and where they are going. 

If no options or directories (dirx ...) are given, install will search a 
set of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that 
order) for a file with the same name as file . When the first occurrence 
is found, install issues a message saying that it is overwriting that file 
with file , and proceeds to do so. If the file is not found, the program 
states this and exits without further action. 

If one or more directories (dirx ...) are specified after file , those 
directories will be searched before the directories specified in the 
default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory 

specified by dira , only if it is not found. If it 
is found, install issues a message saying that 
the file already exists, and exits without 
overwriting it. May be used alone or with the 
-s option. 

-f dirb Forces file to be installed in given directory, 

whether or not one already exists. If the file 
being installed does not already exist, the 
mode and owner of the new file will be set to 
755 and bin, respectively. If the file already 
exists, the mode and owner will be that of the 
already existing file. May be used alone or 
with the -o or -s options. 
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-n dire 


-m mode 

-u user 

-g group 

-o 


-s 

See Also 


make(CP) 


INSTALL (ADM) 

Ignores default directory list, searching only 
through the given directories (dirx ...). May 
be used alone or with any other options 
except -c and -f. 

If file is not found in any of the searched 
directories, it is put in the directory specified 
in dire. The mode and owner of the new file 
will be set to 755 and bin, respectively. May 
be used alone or with any other options 
except -c and -f. 

The mode of the new file is set to mode. Only 
available to the superuser. 

The owner of the new file is set to user. Only 
available to the superuser. 

The group id of the new file is set to group. 
Only available to the superuser. 

If file is found, this option saves the ‘‘found” 
file by copying it to OhDfile in the directory 
in which it was found. This option is useful 
when installing a frequently used file such as 
/ bin/sh or / etc/getty , where the existing file 
cannot be removed. May be used alone or 
with any other options except -c. 

Suppresses printing of messages other than 
error messages. May be used alone or with 
any other options. 
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initcond 

special security actions for init and getty 

^ Syntax _ 

/tcb/lib/initcond [ init I getty ] [ args ... ] 

Description 


To save space in the init( M) and getty( M) programs, which are mem¬ 
ory resident, the space intensive security actions are done in initcond 
as a sub-process of these programs. 

If the argument is init, one of two actions may occur. First, no argu¬ 
ment means that initcond should prompt for and verify a single user 
password if required by the System Default database. This is used for 
password checking before a single user shell. Second, if two other 
arguments are supplied, they are the terminal device name and the 
user name respectively of the session that just terminated. This infor¬ 
mation is reflected in both the Protected Password and Terminal Con¬ 
trol databases. 


If the argument is getty, and one additional argument is provided, it is 
the terminal to be invalidated before a login, initcond invalidates a 
terminal by setting a restricted set of permissions on the terminal de¬ 
vice and by using stopio( S) to invalidate all open file descriptors that 
reference the terminal. These include synonym devices for the same 
physical device as listed in the device assignment database. 


Files 


/tcb/files/initcondlog - Log file for init and getty events 
/etc/auth/system/ttys - Terminal Control database 
/etc/auth/system/devassign - Device Assignment database 

See Also 


getprtcent(S), stopio(S), getdvagent(S), “Maintaining System Secu¬ 
rity,” chapter of the System Administrator's Guide 

Value Added 


initcond is an extension of AT&T System V provided by The Santa 
Cruz Operation, Inc. 
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initscript 

defines environment for programs executed by init(M) 

Description 

/etc/initscript is used to define the default environment for all com¬ 
mands started by init(M). It is the central location for environment 
variables that must be defined for a command. This avoids the prob¬ 
lems inherent in hard-coded values for such variables as HZ and 
PATH. The following is the default contents of /etc/initscript: 

PATH=/bin:/usr/bin 
export PATH 

HZ=60 
export HZ 

[ -x /etc/TIMEZONE ] && . /etc/TIMEZONE 
ulimit 1000 
eval exec "$4" 


Notes 


Variables other than TZ should not be defined in /etc/TIMEZONE as 
in previous releases; they should be moved to /etc/initscript. 

Value Added 


initscript is an extension of AT&T System V provided by The Santa 
Cmz Operation, Inc. 
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installpkg 

install package 

Syntax 

installpkg 

Description 


The installpkg command is used to install an AT&T-style UNIX sys¬ 
tem software package. 

You will have to be root to install certain packages successfully. 

You will be prompted to insert the floppy disk that the installation 
package resides on. Everything else is automatic. 

Notes 

You must invoke installpkg on the console. 

This command does not work on packages installed with 
custom(ADM). 

See Also 

displaypkg(ADM), removepkg(ADM) 
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integrity __ 

examine system files against the authentication data¬ 

base 

Syntax 

integrity [ -v ] [ -e ] [ -m ] 

Description__. 

integrity traverses the File Control database and compares each entry 
in turn to the real file in the file system. If the owner, group or per¬ 
missions are different, an error message is output. 

Wild card entries in the File Control database are handled as follows. 
For file names, those file names that have I* as the last entry are 
treated as wild cards. Any file in the directory matches that entry, 
unless the specific file under consideration has its own (non-wild 
card) entry in the database appearing before the wild card entry. In 
this case, the file is ignored in the check because it would have 
already been located previously. For owners (groups), if the File Con¬ 
trol entry does not explicitly list an owner (group), all owners (groups) 
match correctly. 

The -v option lists all files under consideration, even those that match. 
The -e option explains why discretionary checks fail and exactly what 
the discrepancy is. 

Normally, (non-wild card type) files in the File Control database that 
are missing from the file system are not reported. The -m option will 
override that default and report such missing files. 

Files 


/etc/auth/system/files - File Control database 
/etc/auth/system/default - System Defaults database 

See Also 


authck(ADM), stat(S), getprfient(S), “Maintaining System Security,” 
chapter of the System Administrator’s Guide 
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integrity returns a zero exit status if there are no discrepancies. Other¬ 
wise, integrity returns a positive value equal to the number of 
discrepancies. 

Value Added 


integrity is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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ipcrm __ 

removes a message queue, semaphore set or shared 

memory ID 

Syntax 

ipcrm [ options ] 

Description 


ipcrm removes one or more specified messages, a semaphore or 
shared memory identifiers. The identifiers are specified by the fol¬ 
lowing options : 

-q msqid removes the message queue identifier msqid from the 
system and destroys the message queue and data struc¬ 
ture associated with it. 

-m shmid removes the shared memory identifier shmid from the 
system. The shared memory segment and data structure 
associated with it are destroyed after the last detach. 

-s semid removes the semaphore identifier semid from the sys¬ 
tem and destroys the set of semaphores and data struc¬ 
ture associated with it. 


-Q msgkey removes the message queue identifier, created with key 
msgkey , from the system and destroys the message 
queue and data structure associated with it. 

-M shmkey removes the shared memory identifier, created with key 
shmkey , from the system. The shared memory segment 
and data structure associated with it are destroyed after 
the last detach. 

-Ssemkey removes the semaphore identifier, created with key 
semkey , from the system and destroys the set of sema¬ 
phores and data structure associated with it. 

The details of the removes are described in msgctl( S), shmctl{ S), and 
semctl( S). The identifiers and keys may be found by using 
ipcs{ ADM). 
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ipcs(ADM), msgctl(S), msgget(S), msgop(S), semctl(S), semget(S), 
semop(S), shmctl(S), shmget(S), shmop(S) 


Note 


ipcrm cannot be used to remove semaphores created using 
creatsem(S ) or to remove shared memory created using sdget(S). 


March 15, 1989 


IPCRM-2 










IPCS(ADM) 


IPCS (ADM) 


ipcs __ 

reports the status of inter-process communication 

facilities 

Syntax 

ipcs [ options ] 

Description 

ipcs prints certain information about active inter-process communica¬ 
tion facilities. Without options, information is printed in short format 
for message queues, shared memory, and semaphores that are 
currently active in the system. Otherwise, the information that is dis¬ 
played is controlled by the following options: 

-q Print information about active message queues. 

-m Print information about active shared memory segments. 

-s Print information about active semaphores. 

If any of the options -q, -m, or -s are specified, information about only 
those indicated are displayed. If none of the three options are 
specified, information about all three are displayed. 

-b Print biggest allowable size information (maximum number of 
bytes in messages on queue for message queues, size of segments 
for shared memory, and number of semaphores in each set for 
semaphores). See below, for the meaning of columns in a listing. 

-c Print creator’s login name and group name. See below. 

-o Display information on outstanding usage (number of messages on 
queue, total number of bytes in messages on queue, and the number 
of processes attached to shared memory segments). 

-p Display process number information. (Process ID of last process to 
send a message and process ID of last process to receive a message 
on message queues. It displays the process ID of the creating pro¬ 
cess and the process ID of the last process to attach or detach on 
shared memory segments.) See below. 

-t Print time information. (Time of the last control operation that 
changed the access permissions for all facilities. Time of last 
msgsnd and last msgrcv on message queues, last shmat and last 
shmdt on shared memory, and last semopi S) on semaphores.) See 
below. . 

-a Use all print options. (This is a shorthand notation for -b, -c, -o, 
-p, and -t.) 

-C corefile 

Use the file corefile in place of /dev/kmem. 
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-N namelist 

The argument will be taken as the name of an alternate namelist 
(/unix is the default). 

-X Print information about XENIX interprocess communication, in 
addition to the standard interprocess communication status. The 
XENIX process information describes a second set of semaphores 
and shared memory. Note that the -p option does not print process 
number information for XENIX shared memory, and the -t option 
does not print time information about XENIX semaphores and 
shared memory. 

The column headings and the meaning of the columns in an ipcs list¬ 
ing are given below; the letters in parentheses indicate the options that 
cause the corresponding heading to appear; all means that the heading 
always appears. Note that these options only determine what informa¬ 
tion is provided for each facility; they do not determine which facili¬ 
ties will be listed. 


T 

(all) 

ID 

(all) 

KEY 

(all) 


MODE (all) 


Type of the facility: 

q message queue; 

m shared memory segment; 

s semaphore. 

The identifier for the facility entry. Note that ID is 
“X” for facilities created using creatsem(S) or 
sdget( S). 

The key used as an argument to msgget, semget, or 
shmget to create the facility entry. (Note: The 
key of a shared memory segment is changed to 
IPC PRIVATE from when the segment has been 
removed until all processes attached to the seg¬ 
ment detach it.) 

The facility access modes and flags: The mode 
consists of 11 characters that are interpreted as 
follows: 

The first two characters are: 

R if a process is waiting on a msgrcv ; 

S if a process is waiting on a msgsnd ; 

D if the associated shared memory segment 
has been removed. It will disappear when 
the last process attached to the segment 
detaches it; 

C if the associated shared memory segment 
is to be cleared when the first attach is 
executed; 

if the corresponding special flag is not set. 


The next 9 characters are interpreted as three sets 
of three bits each. The first set refers to the 
owner’s permissions; the next to permissions of 
others in the user-group of the facility entry; and 
the last to all others. Within each set, the first 
character indicates permission to read, the second 
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OWNER (all) 
GROUP (all) 

CREATOR(a,c) 
CGROUP (a,c) 

CBYTES (a,o) 

QNUM 

(a,o) 

QBYTES (a,b) 

LSPID 

(a,p) 

LRPID 

(a,p) 

STIME 

(a,t) 

RTIME 

(a,t) 

CTIME 

(a,t) 

NATTCH (a,o) 

SEGSZ 

(a,b) 

CPID 

(a,p) 

LPID 

(a,p) 

ATIME 

(a,t) 

DTIME 

(a,t) 

NSEMS 

(a,b) 

OTIME 

(a,t) 


IPCS(ADM) 


character indicates permission to write or alter the 
facility entry, and the last character is currently 
unused. 

The permissions are indicated as follows: 

r if read permission is granted; 
w if write permission is granted; 
a if alter permission is granted; 

if the indicated permission is not granted. 
The login name of the owner of the facility entry. 
The group name of the group of the owner of the 
facility entry. 

The login name of the creator of the facility entry. 
The group name of the group of the creator of die 
facility entry. 

The number of bytes in messages currently out¬ 
standing on the associated message queue. 

The number of messages currently outstanding on 
the associated message queue. 

The maximum number of bytes allowed in mes¬ 
sages outstanding on the associated message 
queue. 

The process ID of the last process to send a mes¬ 
sage to the associated queue. 

The process ID of the last process to receive a 
message from the associated queue. 

The time the last message was sent to the associ¬ 
ated queue. 

The time the last message was received from the 
associated queue. 

The time when the associated entry was created or 
changed. 

The number of processes attached to the associ¬ 
ated shared memory segment. 

The size of the associated shared memory seg¬ 
ment. 

The process ID of the creator of the shared mem¬ 
ory entry. 

The process ID of the last process to attach or 
detach the shared memory segment. 

The time the last attach was completed to the 
associated shared memory segment. 

The time the last detach was completed on the 
associated shared memory segment. 

The number of semaphores in the set associated 
with the semaphore entry. 

The time the last semaphore operation was com¬ 
pleted on the set associated with the semaphore 
entry. 
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Files 


IPCS (ADM) 


/unix system namelist 

/dev/kmem memory 
/etc/passwd user names 
/etc/group group names 

See Also 


msgop(S), semop(S), shmop(S) in the Programmer’s Reference Manu- 
al 


Warning 


If the user specifies either the -C or -N flag, the real and effective 
UID/GID will be set to the real UID/GID of the user invoking ipcs. 

Notes 


Things can change while ipcs is running; the picture it gives is only a 
close approximation. 

Authorization 


The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys¬ 
tem” chapter of the User’s Guide for more details. 
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kbmode 


set keyboard mode or test keyboard support 

Syntax 



kbmode command [ file ] 

Description 

This command can be used to determine if your system keyboard sup¬ 
ports AT mode. If it does, this utility can change the keyboard mode in 
between AT mode and PC/XT compatibility mode. 

If the file argument is specified, it should be a tty device of one of the 
multiscreens of the keyboard’s group. 

Valid commands are: 


test - determine if keyboard supports AT mode 

at - set keyboard to AT mode 

xt - set keyboard to PC/XT compatibility mode 



Notes 


Some keyboards look like AT keyboard but do not support AT mode. 
Setting such a keyboard to AT mode will render it useless, unless it 
can be set to XT mode from another (serial) terminal. 

See Also 


keyboard(HW) 

Value Added 


kbmode is an extension of AT&T System V provided by the Santa 
Cruz Operation. 



March 15, 1989 


KBMODE-1 










KILLALL (ADM) 


KILLALL (ADM) 


killall _ 

kill all active processes 

^ Syntax _ 

/etc/killall [ signal ] 

Description 


The killall command is used by /etc/shutdown to kill all active pro¬ 
cesses not directly related to the shutdown procedure. 

The killall command terminates all processes with open files so that 
the mounted file systems will be unbusied and can be unmounted. 

The killall command sends signal [see kill(C')] to all processes not 
belonging to the above group of exclusions. If no signal is specified, a 
default of 9 is used. 


Files 


/etc/shutdown 


See Also 

kill(C), ps(C), shutdown(ADM), signal(S) 

Notes 


The killall command can be run only by the super-user. 

Standards Conformance 


killall is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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labelit _ 

provide labels for filesystems 

Syntax 

/etc/labelit special [ fsname volume [ -n ] ] 

Description 


The labelit command can be used to provide labels for unmounted 
disk file systems or file systems being copied to tape. The -n option 
provides for initial labeling only. (This destroys previous contents.) 

With the optional arguments omitted, labelit prints current label 
values. 

The special name should be the physical disk section (e.g., 
/dev/dsk/0s3). The device may not be on a remote machine. 

The fsname argument represents the mounted name (e.g., root, ul, 
etc.) of the file system. 

Volume may be used to equate an internal name to a volume name 
applied externally to the disk pack, diskette, or tape. 

For file systems on disk, fsname and volume are recorded in the super 
block. 

See Also 


sh(C), filesystem(F) 

Standards Conformance 


labelit is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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link, unlink _ 

link and unlink files and directories 

Syntax 

/etc/link filel file2 
/etc/unlink file 

Description 


The link command is used to create a file name that points to another 
file. Linked files and directories can be removed by the unlink com¬ 
mand; however, it is strongly recommended that the rm(C) and 
rmdir( C) commands be used instead of the unlink command. 

The only difference between ln(C) and link/ unlink is that the latter do 
exactly what they are told to do, abandoning all error checking. This 
is because they directly invoke the link(S) and unlink (S) system calls. 

See Also 


rm(C), link(S), unlink(S) 

Notes 


These commands can be run only by the super-user. 

Standards Conformance 


link and unlink are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

The X/Open Portability Guide II of January 1987; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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link_unix _ 

builds a new UNIX system kernel 

Syntax 


/etc/conf/cf.d/link_unix 

Description 


After installing a device driver, use link unix to build a new UNIX 
system kernel. This script builds /etc/conf/cf.d/unix using the current 
system configuration in /etc/conf. 

See Also 


configure!ADM), idbuild(ADM), “Adding Device Drivers with the 
Link Kit’ ’ in the System Administrator’s Guide 


Value Added 


linkjmix is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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list _ 

list processor channel for MMDF 
Syntax 

list 

Description 


List is an MMDF channel program for handling mailing lists. The 
channel functions as a feed-through between deliver and submit. The 
list channel has its own host table and domain table with one entry for 
the pseudo host “list-processor” or something similar. This program 
is called by the program deliver and is not meant to be invoked by 
users directly. 

The list channel performs two basic services. First, it postpones the 
verification of the list addresses and performs the (possibly lengthy) 
verification in the background when the list channel resubmits the 
message to the mail system. This prevents tying up a network connec¬ 
tion or a user’s terminal when verifying a long mailing list. Second, 
the list channel will, under special circumstances, change the return 
address for the message to a generic maintainer’s address. The return 
address is determined by first taking the destination address (e.g. “lar- 
gelist”) and seeing if there is an address in the alias file called 
“largelist-request”. If there is, then “largelist-request’ ’ is used as the 
return address. If that was not found, the list channel checks to see if 
the destination address has a trailing “-outbound”. If so, this is 
stripped and a “-request” is added and the lookup in the alias file is 
made a second time. If the “-request” address is found, then that 
address is used as the return address. If no “-request” address is 
found, then the original return address is used (normally the address of 
the sender). 

To use the list channel to process a list, it is generally necessary to 
make three entries in the alias file(s). Let us say that we wish to set up 
a list called “largelist’ ’ and we want this list to be processed by the 
list channel. We would need the following entries in the alias file: 

largelist: largelist-outbound@list-processor 

largelist-outbound: </usr/mmdf/lists/largelist-file 

largelist-request: maintainer 

The first line causes mail sent to “largelist’ ’ to be sent through the list 
processor, readdressed to “largelist-outbound”. The second line is 
what actually references the mailing list file for “largelist’ ’. The third 
line is optional, and is used to set up the (informal) standard mainte¬ 
nance address. This -request address, if present, will also be used by 
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the list channel as the return address for mail submitted to the list. 

See Also 

deliver(ADM), submit(ADM) 

Files 

<mmdf-table-directory>/aliases - to find list -request addresses 


March 15, 1989 


LIST-2 





LPADMIN (ADM) 


LPADMIN (ADM) 


Ipadmin _ 

configure the print service 

Syntax 


/usr/lib/lpadmin -p printer options 

/usr/lib/lpadmin -x dest 
/usr/lib/lpadmin -d [dest] 

/usr/lib/lpadmin -S print-wheel -A alert-type [-W integer \ ] 
[-Q integer 2 ] 

Description 


Ipadmin configures the LP print service to describe printers and de¬ 
vices. It is used to add and change printers, to remove printers from 
the service, to set or change the system default destination, and to 
define alerts for print wheels, and to define printers for remote print¬ 
ing services. 

Adding or Changing a Printer 


The first form of the Ipadmin command (Ipadmin -p printer options) 
is used to configure a new printer or to change the configuration of an 
existing printer. The following options are used and may appear in 
any order. For ease of discussion, the printer will be referred to as P 
below. 

-F fault-recovery 

Restores the LP print service after a printer fault according to 
the value of fault-recovery: 

continue Continues printing on the top of the page where print¬ 
ing stopped. This requires a filter to wait for the fault 
to clear before automatically continuing. 

beginning 

Starts printing the request again from the beginning. 

wait Disables printing on the printer and waits for the 
administrator or a user to enable printing again. 

During the wait, the administrator or the user who 
submitted the stopped print request can issue a change 
request that specifies where printing should resume. If 
no change request is made before printing is enabled, 
printing will resume at the top of the page where 
stopped if the filter allows; otherwise, the request will 
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be printed from the beginning. 

This option specifies the recovery to be used for any print 
request that is stopped because of a printer fault. 

-c class 

Inserts printer P into the specified class, class will be created if 
it does not already exist. 

-D comment 

Saves comment for display whenever a user asks for a full 
description of the printer P [see lpstat( C)]. The LP print service 
does not interpret this comment. 

-e printer 

Copies an existing printer's interface program to be the new 
interface program for printer P. 

-f d\\ovt:form-list 
-f deny \form-list 

Allows (-f allow) or denies (-f deny) the forms in form-list to be 
printed on printer P. 

For each printer, the LP print service keeps two lists of forms: 
an li“allow-list’ ’ of forms that can be used with the printer and 
a “deny-list” of forms that shouldn’t be used with the printer. 
With the -f allow option, the forms listed are added to the 
allow-list and removed from the deny-list. With the -f deny 
option, the forms listed are removed from the allow-list and 
added to the deny-list. 

If the allow-list is not empty, the forms in the list can be used 
with the printer and all others cannot regardless of the content 
of the deny-list. If the allow-list is empty but the deny-list is 
not, the forms in the deny-list cannot be used with the printer. 
All forms can be excluded from a printer by having an empty 
allow-list and putting the word any in the deny-list. All forms 
can be used on a printer by having an empty deny-list and speci¬ 
fying any for the allow-list, provided the printer can handle all 
the characteristics of the forms. 

The LP print service uses this information as a set of guidelines 
for determining where a form can be mounted. Administrators, 
however, are not restricted from mounting a form on any printer. 
If mounting a form on a particular printer is in disagreement 
with the information in the allow-list or deny-list, the adminis¬ 
trator is warned, but the mount is accepted. Nonetheless, if a 
user attempts to issue a print or change request for a form and 
printer combination that is in disagreement with the informa¬ 
tion, the request is accepted only if the form is currently 
mounted on the printer. If the form is later unmounted before 
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the request can print, the request is canceled, and the user is 
notified by mail. 

If an administrator tries to name a form as acceptable for use on 
a printer that doesn’t have the capabilities needed by the form, 
the command is rejected. 

Note the other use of -f below. 

-h Indicates that the device associated with P is hardwired. This 
option is assumed when adding a new printer unless the -1 
option is supplied. 

-i interface 

Establishes a new interface program for P. interface is the path 
name of the new program. 

-I content-type-list 

Assigns P to handle print requests with content of a type listed 
in content-type-list. 

The type simple is recognized as the default content-type of 
files on the system. Such a data stream contains only printable 
ASCn characters and the following control characters: 

Control Character Octal Value_Meaning_ 

10 g move back to previous column, 

except at beginning of line 
11 g move to next tab stop 

12 g move to beginning of next line 

14 g move to beginning of next page 

15 g move to beginning of current line 

To force the print service to not consider simple as a valid type 
for the printer, give an explicit value (e.g., the printer type) in 
the content-type-list. If you do want simple included along with 
other types, you must include simple in the content-type-list. 

Each printer automatically has its printer type included in the 
list of content types it will accept. 

Except for simple, each content-type name is freely determined 
by the administrator. If names given as content types are also 
printer types, the names are accepted without comment because 
the LP print service recognizes all printer types as potential con¬ 
tent types as well. 

Indicates that the device associated with P is a login terminal. 
The LP scheduler, Ipsched, disables all login terminals automat¬ 
ically each time it is started. Before re-enabling P, its current 
device should be established using Ipadmin. 


backspace 

tab 

linefeed (newline) 
form feed 
carriage return 
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-M -fform-name [-a [-o filebreak]] 

Mounts the form form-name on P. Print requests to be printed 
with the pre-printed form form-name will be printed on P . If 
more than one printer has the form mounted and the user has 
specified any (with the -d option of the lp command) as the 
printer destination, then each print request will be printed on the 
one that meets the other needs of the request. 

The page length and width and character and line pitches 
needed by the form are compared with those allowed for the 
printer by checking the capabilities in the terminfo( F) database 
for the type of printer. If the form requires attributes that are not 
available with the printer, the administrator is warned, but the 
mount is accepted. If the form lists a print wheel as mandatory 
but the print wheel mounted on the printer is different, the 
administrator is also warned but the mount is accepted. 

If the -a option is given, an alignment pattern is printed, pre¬ 
ceded by the same initialization of the physical printer that pre¬ 
cedes a normal print request with one exception: no banner 
page is printed. Printing is assumed to start at the top of the first 
page of the form. After the pattern is printed, the administrator 
can adjust the mounted form in the printer, press return for 
another alignment pattern (no initialization this time), and con¬ 
tinue printing as many alignment patterns as desired. The 
administrator can quit the printing alignment patterns by typing 
"q". 

If the -o filebreak option is given, a formfeed is inserted 
between each copy of the alignment pattern. By default, the 
alignment pattern is assumed to correctly fill a form, so no 
formfeed is added. 

A form is unmounted by mounting a new form in its place using 
the -f option. The -f none option can be used to specify no form. 
By default, a new printer has no form mounted. 

Note the other use of -f above. 

-M -S print-wheel 

Mounts the print wheel print-wheel on P. Print requests to be 
printed with print-wheel will be printed on P. If more than one 
printer has the print-wheel mounted and the user has specified 
any (with the -d option of the lp command) as the printer desti¬ 
nation, then each print request will be printed on the one that 
meets the other needs of the request. 

If the print-wheel is not listed as acceptable for the printer, the 
administrator is warned, but the mount is accepted. If the 
printer does not take print wheels, the command is rejected. 
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A print wheel is unmounted by mounting a new print wheel in 
its place or by using the -S none option. 

By default, a new printer has no special print wheel mounted. 
Until this is changed, a print request that asks for a specific print 
wheel will not be printed on P. 

Note the other uses of the -S option described below. 

-m model 

Selects a model interface program provided with the LP print 
service for printer P. 

-o printing-option 

Each -o option in the list below is the default given to an inter¬ 
face program if the option is not taken from a preprinted form 
description or is not explicitly given by the user submitting a 
request [see lp( C)]. The only -o options that can have defaults 
defined are listed below: 

length =scaled-decimal-number 
width =scaled-decimal-number 
cpi=scaled-decimal-number 
lpi =scaled-decimal-number 
stty -stty-option-list 

The term scaled-decimal-number refers to a non-negative num¬ 
ber used to indicate a unit of size. (The type of unit is shown by 
a trailing letter attached to the number.) Three types of scaled 
decimal numbers are discussed for the LP print service: num¬ 
bers that show sizes in centimeters (marked with a trailing c), 
numbers that show sizes in inches (marked with a trailing i), and 
numbers that show sizes in units appropriate to use (without a 
trailing letter), i.e., lines, columns, lines per inch, or characters 
per inch. 

The first four default option values should agree with the capa¬ 
bilities of the type of physical printer as defined in the 
terminfo( F) database for the printer type. If they do not, the 
command is rejected. 

The stty-option-list is not checked for allowed values but is 
passed directly to the stty(C) program by the standard interface 
program. Any error messages produced by stty(C ) when a 
request is processed (by the standard interface program) are 
mailed to the user submitting the request. 

For each printing option not specified, the defaults for the fol¬ 
lowing attributes are defined in the Terminfo entry for the 
specified printer type: 

length 

width 

cpi 
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Ipi 

The default for stty is 

stty=9600 cs8 -cstopb -parenb -paroff ixon 
-ixany opost -olcuc -onlcr -ocml -onocr 
-onlret -ofill nlO crO tabO bsO vtO flD 

You can set any of the -o options to the default values (which 
vary for different types of printers) by typing them without 
assigned values as follows: 

Length= 

width= 

cpi= 

lpi= 

stty= 

-o nobanner 

Allows users to submit a print request that asks that no banner 
page be printed. 

-o banner 

Forces a banner page to be printed with every print request, 
even when a user asks for no banner page. This is the default; 
you must specify -o nobanner if you want to allow users to 
specify -o nobanner with the lp command. 

-R machine-list 

Sets up remote machines in machine-list to share print services. 
The LP print service arranges for the advertising and mounting 
of all necessary resources and for automatic recovery of shared 
print services when the machine is brought to a state where RFS 
is run. 

The LP Spooler keeps the parts of the print service owned by 
each machine separate, so that the administrator on one machine 
can change only the service provided by his or her machine. 
The LP Spooler provides for no centrally managed print service 
using RFS. 

-r class 

Removes printer P from the specified class. If P is the last 
member of the class , then the class will be removed. 


-S list 

Allows the aliases for character sets or print wheels named in 
list to be used with P. 

If the printer is a type that takes print wheels, then list is a list of 
print wheel names separated by commas or spaces. These will 
be the only print wheels considered mountable on the printer. 
(You can always force a different print wheel to be mounted, 
however.) Until the option is used to specify a list, no print 
wheels will be considered mountable on the printer, and print 


March 15, 1989 


LPADMIN-6 



LPADMIN (ADM) 


LPADMIN (ADM) 


requests that ask for a particular print wheel with this printer 
will be rejected. 

If the printer is a type that has selectable character sets, then list 
is a list of character set name mappings or aliases separated by 
commas or spaces. Each mapping is of the form 

known-name = synonym 

known-name is a character set number preceded by cs, such as cs3 for 
character set three, or a character set name from the Terminfo data¬ 
base csnm entry. [See terminfo(JF) in the Programmer’s Reference 
Manual .] If this option is not used to specify a list, only the names 
already known from the Terminfo database or numbers with a prefix of 
cs will be acceptable for the printer. 

If list is the word none, the previous print wheel list or character set 
aliases will be removed. 

Note the other uses of the -S option. 

-T printer-type 

Assigns the given printer-type , a representation of a physical 
printer of type printer-type. Printer-type is used to extract data 
from terminfo( F); this data is used to initialize the printer before 
printing each user’s request. Some filters may also use printer- 
type to convert content for the printer. If this option is not used, 
the default printer-type will be unknown; no useful information 
will be extracted from terminfo(F), so each user request will be 
printed without first initializing the printer. Also, this option 
must be used if the following are to work: -o cpi=, -o lpi=, -o 
widths, and -o length= options of the Ipadmin and Ip com¬ 
mands, and the -S and -f options of the Ipadmin command. 

-u allow: user-list 
-u deny :user-list 

Allows (-u allow) or denies (-u deny) the users in user-list 
access to P. 

For normal access to each printer, the LP print service keeps two 
lists of users: an allow-list of people allowed to use the printer 
and a deny-list of people denied access to the printer. With the 
-u allow option, the users listed are added to the allow-list and 
removed from the deny-list. With the -u deny option, the users 
listed are removed from the allow-list and added to the deny- 
list. 

If the allow-list is not empty, the users in the list are allowed 
access to the printer and all others are denied access, regardless 
of the content of the deny-list. If the allow-list is empty but the 
deny-list is not, the users in the deny-list are denied access and 
all others are allowed. If both lists are empty, all users are 
allowed access. Access can be denied to all users except the LP 
print service administrator by putting any in the deny-list. To 
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allow everyone access to P and effectively empty both lists, put 
any in the allow-list. 

-U dial-info 

Assigns the dialing information dial-info to the printer, dial- 
info is used with the dial{ S) routine to call the printer. Any net¬ 
work connection supported by the Basic Networking Utilities 
will work, dial-info can be either a phone number for a modem 
connection or a system name for other kinds of connections. Or 
if -U direct is given, no dialing will take place because the 
name direct is reserved for a printer that is directly connected. 
If a system name is given, it is used to search for connection 
details from the file /usr/lib/uucp/Systems or related files. The 
Basic Networking Utilities are required to support this option. 
By default, -U direct is assumed. 

-v device 

Associates a new device with printer P . device is the path name 
of a file that is writable by Ip. Note that the same device can be 
associated with more than one printer. 

-A alert-type [-W integer ] 

The -A option is used to send the alert alert-type to the adminis¬ 
trator when a printer fault is detected and periodically thereafter 
until the printer fault is cleared by the administrator. The alert- 
types are 

mail 

Sends the alert message via mail [see mail(C )] to the 
administrator who issues this command. 

write 

Writes the message to the terminal on which the administra¬ 
tor is logged in. If the administrator is logged in on several 
terminals, one is chosen arbitrarily. 

quiet 

Does not send messages for the current condition. An 
administrator can use this option to temporarily stop receiv¬ 
ing further messages about a known problem. Once the fault 
has been cleared and printing resumes, messages will again 
be sent when another fault occurs with the printer. 

none 

Does not send messages until this command is given again 
with a different alert-type; removes any existing alert 
definition. No alert will be sent when the printer faults until 
a different alert-type is used (except quiet). 

shell-command 

shell-command is run each time the alert needs to be sent. 
shell-command should expect the message as standard input. 
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If there are blanks embedded in the command, enclose the 
command in quotes. Note that the mail and write values for 
this option are equivalent to the values mail user-name and 
write user-name , respectively, where user-name is the 
current name for the administrator. This will be the login 
name of the person submitting this command unless he or 
she has used the su command to change to another user ID. 
If the su command has been used to change the user ID, then 
the user-name for the new ID is used. 

list 

The type of the alert for the printer fault is displayed on the 
standard output. No change is made to the alert. 

The message sent appears as follows: 

The print wheel print-wheel needs to be mounted 

on the printer(s): 

printer-list 

number-of-requests print requests await this print-wheel. 

The printer printer-name has stopped printing for the reason given 
below. Fix the problem and bring the printer back on line. Printing 
has stopped but will be restarted in a few minutes; issue an enable 
command if you want to restart sooner. 

Unless someone issues a change request 

lp -i request-id -P ... 

to change the page-list to print, the current request will be repeated 
from the beginning. 

The reason(s) it stopped (multiple reasons indicate reprinted 
attempts): 

reason 

The LP print service can detect printer faults only through an adequate 
fast filter and only when the standard interface program or a suitable 
customized interface program is used. Furthermore, the level of 
recovery after a fault depends on the capabilities of the filter. 

If the printer-name is all, the alerting defined in this command applies 
to all existing printers. 

If the -W option is not given or integer j is zero (which represents 
once and is also the default), only one message will be sent per fault. 
If this command is not used to arrange fault alerting for a printer, the 
default procedure is to mail one message to the administrator of the 
printer per fault. 
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Restrictions 


When creating a new printer, either the -v or the -U option must be 
supplied. In addition, only one of the following may be supplied: -e, 
-i, or -m; if none of these three options are supplied, the model stan¬ 
dard is used. The -h and -1 keyletters are mutually exclusive. Printer 
and class names may be no longer than 14 characters and must consist 
entirely of the characters A-Z, a-z, 0-9 and _ (underscore). 

Removing a Printer Destination 

The -x dest option removes the destination dest from the LP print ser¬ 
vice. If dest is a printer and is the only member of a class, then the 
class will be deleted, too. If dest is all, all printers and classes are 
removed. No other options are allowed with -x. 


Changing the System Default Destination 


The -d [dest] option makes dest, an existing destination, the new sys¬ 
tem default destination. If dest is not supplied, then there is no system 
default destination. No other options are allowed with -d. 


Setting an Alert for a Print Wheel 


-S print-wheel -A alert-type [-W integer i ] [-Q integer 2 ] 

The -S print-wheel option is used with the -A alert-type option 
to send the alert alert-type to the administrator as soon as the 
print-wheel needs to be mounted and periodically thereafter. 
The alert-types are 

mail Sends the alert message via mail [see mailiC )] to the 
adminis trator who issues this command. 

write Writes the message to the terminal on which the 
administrator is logged in. If the administrator is 
logged in on several terminals, one is chosen arbi¬ 
trarily. 

quiet Does not send messages for the current condition. An 
administrator can use this option to temporarily stop 
receiving further messages about a known problem. 
Once the print-wheel has been mounted and subse¬ 
quently unmounted, messages will again be sent when 
the number of print requests again exceeds the thresh¬ 
old. 
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none Does not send messages until this command is given 
again with a different alert-type (other than quiet). 

shell-command 

The shell-command is run each time the alert needs to 
be sent. The shell command should expect the mes¬ 
sage as standard input. If there are blanks embedded 
in the command, enclose the command in quotes. 
Note that the mail and write values for this option are 
equivalent to the values mail user-name and write 
user-name, respectively, where user-name is the 
current name for the administrator. This will be the 
login name of the person submitting this command 
unless he or she has used the su command to change to 
another user ID. If the su command has been used to 
change the user ID, then the user-name for the new ID 
is used. 

list The type of the alert for the print wheel is displayed 
on the standard output. No change is made to the 
alert. 

The printers listed are those that the administrator had earlier 
specified were candidates for this print wheel. The number ( 
integer 3 ) listed next to each printer is the number of requests 
eligible for the printer. The number ( integer 4 ) shown after the 
printer list is the total number of requests awaiting the print 
wheel. It will be less than the sum of the other numbers if some 
requests can be handled by more than one printer. 

If the print-wheel is all, the alerting defined in this command 
applies to all print wheels already defined to have an alert. 

Only one administrator per print wheel can be alerted. If this 
command is run by more than one administrator for the same 
print wheel, the last command run applies. 

If the -W option is not given or integer \ is zero (which is inter¬ 
preted as once and is also the default), only one message will be 
sent per need to mount a print wheel. If this command is not 
used to arrange alerting for a print wheel, no alerts will be sent 
for the print wheel. 

If the -Q option is also given, the alert will be made when 
integer 2 print requests that need the print wheel are waiting. If 
the -Q option is not given or integer 2 is 1 or the word any, a 
message is sent as soon as anyone submits a print request for the 
print wheel when it is not mounted. 

The -S option has a different meaning when used with the -p 
option. 
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Defining Remote Printers for Remote Printing Services 


The fourth form of the Ipadmin command is used to define the remote 
printer, printer-name , and its machine, machine-name, that will han¬ 
dle remote print requests from the local machine. The remote printer 
will be be referred to as printer-name j on the local machine. 

Files 


/usr/spool/lp/* 

See Also 


accept(ADM), enable(C), lp(C), lpstat(C), stty(C), lpsched(ADM), 
terminfo(F) 

Authorization 

Permission to use this utility is assigned with the lp authorization, 
which is usually reserved for system administrators. 
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Ipfilter _ 

administer filters used with the print service 

Syntax 


/usr/lib/lpfilter -f filter-name -F path-name 
/usr/lib/lpfilter -f filter-name - 
/usr/lib/lpfilter -f filter-name -i 
/usr/lib/lpfilter -f filter-name -x 
/usr/lib/lpfilter -f filter-name -1 

Description 


Tte Ipfilter command is used to add, change, delete, and list filters 
used with the LP print service. These filters are used to convert the 
content type of a file to a content type acceptable to a given printer. 
One of the following options must be used with the Ipfilter command: 
-* path-name (or - for standard input) to add or change a filter, -i to 
reset an original LP print service filter to its factory setting, -x to 
delete a filter, or -1 to list a filter description. 

The argument all can be used instead of a filter-name with any of 
these options. When all is specified with the -F or - option the 
requested change is made to all filters. Using all with the -i option has 
the effect of restoring to their original settings all filters for which 
predefined settings were initially available. Using the all argument 
with the -I option produces a list of all filters, and using it with the -x 
option results in all filters being deleted. 

Adding or Changing a Filter 


T^ e /j ter name d in the -f option and described in the input is added to 
the filter table. If the filter already exists, its description is changed to 
reflect the new information in the input. Once added, a filter is avail¬ 
able for use. 

TTie filter description is taken from the path-name if the -F option is 
given or from the standard input if the - option is given. One of the 
two must be given to define or change a filter. If the filter named is 
one originally delivered with the LP print service, the -i option will 
restore the original filter description. 

Filters are used to convert the content of a request into a data stream 
acceptable to a printer. For a given print request, the LP print service 
will know the following: 

• the type of content in the request 
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• the name of the printer 

• the type of the printer 

• the types of content acceptable to the printer 

• the modes of printing asked for by the originator of the request 

It will use this information to find a filter that will convert the content 
into a type acceptable to the printer. 

Below is a list of items that provide input to this command and 
descriptions of each item. All lists are separated by commas or 
spaces. 

Input types: content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers: printer-list 
Filter type: filter-type 
Command: shell-command 
Options: template-list 


*This^gives the types of content that can be accepted by the filter. 


This gives the types of content that the filter can produce from any 
of the input content types. 

Printer types ,, ,j 

This gives the type of printers for which the filter can be used. The 

LP print service will restrict the use of the filter to these types of 
printers. 

Printers 

This gives the names of the printers for which the filter can be 
used. The LP print service will restrict the use of the filter to just 
the printers named. 

F ^his^marks the filter as a “slow” filter or a “fast” filter. Slow 
filters are generally those that take a long time to convert their 
input. They are run unconnected to a printer to keep the printers 
from being tied up while the filter is running. Fast filters are gen¬ 
erally those that convert their input quickly or those that must be 
connected to the printer when run. These will be given to the 
interface program to run connected to the physical printer. 

C ° This specifies the program to run to invoke the filter. The program 
name as well as fixed options are included in the shell-command, 
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additional options are constructed, based on the characteristics of 
each print request and on the Options field. 

The command must accept a data stream as standard input and pro¬ 
duce the converted data stream on its standard output. This allows 
filter pipelines to be constructed to convert data not handled bv a 
smgle filter. 

Options 

This is a list of templates separated by commas used by the LP 
print service to construct options to the filter from the characteris¬ 
tics of each print request listed in the table later. In general, each 
template is of the following form: 

keyword pattern = replacement 

The keyword names the characteristic that the template attempts to 
map mto a filter-specific option; each valid keyword is listed in the 
table below. A. pattern is either a literal pattern of one of the forms 
listed m the table or a single asterisk, *; if the pattern matches the 
value of the characteristic, the template fits and is used to generate 
a filter-specific option. A pattern of * matches any value. The 
replacement is a string used as a filter-specific option with an 


lp Option 

Characteristic 

keyword 

-T 

Content type (input) 

INPUT 

N/A 

Content type (output) 

OUTPUT 

N/A 

Printer type 

TERM 

-f, -o cpi= 

Character pitch 

CPI 

-f, -o lpi= 

Line pitch 

LPI 

-f, -o length^ 

Page length 

LENGTH 

-f, -o width= 

Page width 

WIDTH 

-P 

Pages to print 

PAGES 

-S 

Character set/ 
print wheel 

CHARSET 

-f 

Form name 

FORM 

-y 

Modes 

MODES 

-n 

Number of copies 

COPIES 


Possible 


content-type 

content-type 

printer-type 

integer 

integer 

integer 

integer 

page-list 

character-set- 

name/ 

print-wheel-name 

form-name 

mode 

integer _ 


For example, the template 

MODES landscape = -1 

would show that if a print request includes the -y landscape option, 
plat. ter S ^° U ^ ^ 8^ ven option -1. As another example, the tem- 

TERM * = -T * 

would show that the filter should be given the option -T printer-type 
filter ChCVer printer ~ type is associate d with a print request using the 
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When an existing filter is changed with this command, items that are 
not Specified in the new information are left as they were. When a 
new filter is added with this command, unspecified items are given 
default values. 

Note that a filter name and a command must be given. A filter with no 
input type value is assumed to work with any input type; this is a s 
true for the output type, printer type, and printer values. 


Deleting a Filter 


The -x option is used to delete the filter specified in filter-name from 
the LP filter table. 


Listing a Filter Description 


The -1 option is used to list the description of the filter named m 
filter-name. If the command is successful, the following message is 
sent to standard output: 


Input types: content-type-list 
Output types: content-type-list 
Printer types: printer-type-list 
Printers: printer-list 
Filter type: filter-type 
Command: shell-command 
Options: template-list 

If the command fails, an error message is sent to standard error. 


See Also 

lpadmin(ADM), lp(C) 

Authorization ____ 

The use of this utility is governed by assignment of the lp authoriza¬ 
tion, which is usually reserved for system administrators. 
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Ipforms _ 

administer forms used with the print service 

Syntax 


/usr/Iib/lpforms -f form-name option 

/usr/lib/Ipforms -f form-name -A alert-type [-Q integer i] [-W 
integer 2 ] 

/usr/lib/lpforms -f form-name -A list 
/usr/Iib/lpforms -f form-name -A quiet 
/usr/lib/lpforms -f form-name -A none 

Description 


The Ipforms command is used to administer the use of preprinted 
forms, such as company letterhead paper, with the LP print service. 
The first variation of the Ipforms command allows the administrator to 
add, change, and delete forms, to list the attributes of an existing form, 
and to allow and deny users access to particular forms. The second 
variation of Ipforms is used to establish the method by which the 
administrator is alerted that a form must be mounted on a printer. The 
third variation is used to list the current alerting methods assigned to 
forms. The form is specified by the form-name given with the Ipforms 
command. Users may request this form by form-name [see lp(C )]. 
The fourth variation of Ipforms is to terminate an active alert. The 
fifth form is used to remove an alert. 

With the first variation of the Ipforms command, one of the following 
options must be used: 

-F path-name to add or change a form as specified by the information 
in path-name 

To add or change a form, and supply information from 
standard input 

-x to delete a foim 

This option must be used separately; it cannot be used 
with any other option. 

-1 to list the attributes of a form 

This option must be used separately; it cannot be used 
with any other option. 
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-u allow :user-list 

to allow users to request a form 

This option can be used with the -F or - option. 

-u deny '.user-list 

to deny users access to a form 

This option can be used with the -F or - option. 
Each option is explained below. 


Adding or Changing a Form 


The -F path-name option is used to add a new form to the LP print ser¬ 
vice, or to change the attributes of an existing form. The form 
description is taken from path-name if the -F option is given, or the 
standard input if the - option is given. One of the two options must be 
given to define or change a form, path-name is the path name of a file 
that contains all or any subset of the following information about the 
form. 

Page length: scaled—decimal—number\ 

Page width: scaled —decimal —num ber 2 

Number of pages: integer 

Line pitch: scaled -decimal -num ber 3 

Character pitch: scaled-decimal-num ber 4 

Character set choice: character-set!print-wheel, [mandatory] 

Ribbon color: ribbon-color 

Comment: 

comment 

Alignment pattern: [content-type] 
content 

Except for the last two lines, the above lines can appear in any order. 
The Comment: and comment items must appear inconsecutive order 
but can appear before the other items, and the Alignment pattern, 
and the content items must appear in consecutive order at the end of 
the file. Also, the comment item cannot contain a line that begins with 
any of the key phrases above, unless the key phrase is preceded with a 
">" sign. Any leading > sign found in the comment will be removed 
when the comment is displayed. Case distinctions in the key phrases 
are ignored. 

Upon issuing this command, the form named in form-name is added to 
the list of forms. If the form already exists, its description is changed 
to reflect the new information in the input. Once added, a form is 
available for use in a print request, except where access to the form 
has been restricted, as described under the -u allow: option. A form 
may also be allowed to be used on certain printers only. 
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A description of each form attribute is below: 


Page length and Page Width 

Before printing the content of a print request needing this form the 
generic interface program provided with the LP print service will 
inmate the physical printer to handle pages 
scaled-decimal-number i long, and scaled-decimal-number? 
wide using the printer type as a key into the terminfo(F) database 
A scaled-decimal-number is an optionally scaled decimal number 
that givesa size in lines, columns, inches, or centimeters, as appro¬ 
priate. The scale is indicated by appending the letter ’i’, for 
inches, or the letter V, for entimeters. For length or width settings 
an unsealed number indicates lines or columns; for line pitch or 
character pitch settings, an unsealed number indicates lines per 
mch or characters per inch (the same as a number scaled with T). 
For example, length=66 indicates a page length of 66 lines, 
J eng th=lli indicates a page length of 11 inches, and 
length=27.94c indicates a page length of 27.94 centimeters 


len S th anc ^ P a 8 e width will also be passed, if possible, to 
each filter used in a request needing this form. 


Number of pages 

Each time the alignment pattern is printed, the LP print service 
will attempt to truncate the content to a single form by, if possible 
passing to each filter the page subset of 1- integer. 

Line pitch and Character pitch 

Before printing the content of a print request needing this form, the 
interface programs provided with the LP print service will initial¬ 
ize the physical printer to handle these pitches, using the printer 
type as a key into the terminfo{¥) database. Also, the pitches will 
be passed, if possible, to each filter used in a request needing this 
form. Scaled -decimal -number 3 is in lines per centimeter if a ‘c’ 
1S i a PP c ; n ^ e ^> an ^ lines per inch otherwise; similarly, 
scaled —decimal —num ber 4 is in columns per centimeter if a ‘c’ is 
appended, and columns per inch otherwise. The character pitch 
can also be given as elite (12 characters per inch), pica (10 charac- 
P er mc h), or compressed (as many characters per inch as pos- 


Character set choice 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the print wheel print-wheel should 
be used on those printers that take print wheels. If printing with 
this form is to be done on a printer that has selectable or loadable 
character sets instead of print wheels, the interface programs pro¬ 
vided with the LP print service will automatically select or load 
t e correct character set. If mandatory is appended, a user is not 
allowed to select a different character set for use with the form; 
otherwise, the character set or print wheel named is a suggestion 
and a default only. 
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Ribbon color , . * * 

When the LP print service alerts an administrator to mount this 
form, it will also mention that the color of the ribbon should be 
ribbon-color. 

Comment . , , 

The LP print service will display the comment unaltered when a 

user asks about this form [see lpstat( C)]. 

Alignment pattern , , A , 

When mounting this form an administrator can ask that the content 
be repeatedly printed, as an aid in correctly positioning the pre¬ 
printed form. The optional content-type defines the type of printer 
for which content had been generated. If content-type is not given, 
simple is assumed. Note that the content is stored as given, and 
will be readable only by the user lp. 


When an existing form is changed with this command, items missing 
in the new information are left as they were. When a new form is 
added with this command, missing items will get the following 
defaults: 


Page Length: 66 
Page Width: 80 
Number of Pages: 1 
Line Pitch: 6 
Character Pitch: 10 
Character Set Choice: any 
Ribbon Color: any 
Comment: (no default) 
Alignment Pattern: (no default) 


Deleting a Form 

The -x option is used to delete the form specified in form-name from 
the LP print service. 


Listing Form Attributes 

The -1 option is used to list the attributes of the existing form specified 
by form-name. The attributes listed are those described under Ad - 
ing and Changing a Form," above. Because of the potentially sensi- 
five nature of the alignment pattern, only the administrator can exam¬ 
ine the form with this command. Other people can use the lpstat( L) 
command to examine the non-sensitive part of the form description. 

Allowing and Denying Access to a Form 

The LP print service keeps two lists of users for each form, an allow- 
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list of people allowed to use the form, and a deny-list of people denied 
access to the form. With the -u allow: option, the users listed are 
added to the allow-list and removed from the deny-list. With the 
-u deny: option, the users listed are removed from the allow-list and 
added to the deny-list. 

If the allow-list is not empty, the users in the list are allowed access to 
the form and all others are denied access, regardless of the content of 
the deny-list. If the allow-list is empty, but the deny-list is not, the 
users in the deny-list are denied access and all others are allowed. If 
both lists are empty, all users are allowed access. Access can be 
denied to all users, except the LP print service administrator, by put¬ 
ting any in the deny-list. To effectively empty both lists, allowing 
access for everyone, put any in the allow-list. 

Alerting to Mount Forms 


The second variation of the Ipforms command is used to arrange for 
the alerting to mount forms on a printer. 

When integer i print requests needing the preprinted form form-name 
become queued up because no printer satisfying all the needs of the 
requests has the form mounted, and for as long as this condition 
remains, an alert is sent to the administrator every integer 2 minutes 
until the form is mounted on a qualifying printer. If the form-name is 
all, the alerting defined in this command applies to all existing forms. 
No alerting is done for a backlog of print requests needing a form if 
the administrator does not use this option. 

The method for sending the alert depends on the value of the -A 
option. 

write 

The message is sent via write(C) to the terminal on which the 
administrator is logged in when the alert arises. If the administra¬ 
tor is logged in on several terminals, one is chosen arbitrarily. 

mail 

The message is sent via mail to the administrator who issues this 
command. 

The message sent appears as follows: 

The form form-name needs to be mounted on the printer(s). 
printer-list (integer 3 requests) 
integer 4 print request awaits this form. 

Use the ribbon-color ribbon. 

Use the print-wheel print wheel , if appropriate. 
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The printers listed are those that the administrator had earlier 
specified were candidates for this form. The number ( integer 3 ) 
listed next to each printer is the number of requests eligible for the 
printer. The number ( integer 4 ) shown after the printer list is the total 
number of requests awaiting the form. It will be less than the sum of 
the other numbers if some requests can be handled by more than one 
printer. The ribbon-color and print-wheel are those given in the form 
description. The last line in the message is given even if none of the 
printers listed use print wheels, because the administrator may choose 
to mount the form on a printer that does use a print wheel. 

Where any color ribbon or any print wheel can be used, the statements 
above will read: 

Use any ribbon. 

Use any print-wheel. 

shell-command 

The shell-command is run each time the alert needs to be sent. The 
shell command should expect the message as standard input. Note 
that the mail and write values for the -A command are equivalent 
to the values mail user-name and write user-name, respectively, 
where user-name is the current name for the administrator. This 
will be the login name of the person submitting this command 
unless he or she has used the su command to change to another 
user ID. If the su command has been used to change the user ID, 
then the user-name for the new ID is used. 

If the -Q option is not given or integer 1 is one or the word any (which 
is the default), a message is sent as soon as anyone submits a print 
request for the form when it is not mounted. 

If the -W option is not given or integer 2 is zero or the word once 
(which is the default), only one message is sent when the queue size 
exceeds integer 1. 

Listing the Current Alert 

The third variation of Ipforms is used to list the type of the alert for the 
specified form. No change is made to the alert. If form-name is recog¬ 
nized by the LP print service, one of the following lines is sent to the 
standard output, depending on the type of alert for the form. 

When integer are queued: alert with shell-command every integer 
minutes 

When integer are queued: write to user-name every integer minutes 
When integer are queued: mail to user-name every integer minutes 
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The phrase every integer minutes is replaced with once if integer 7 
(the -W integer 2 ) is 0 . 

Terminating an Active Alert 


The quiet option is used to stop messages for the current condition. 
An administrator can use this option to temporarily stop receiving 
further messages about a known problem. Once the form has been 
mounted and then unmounted, messages will again be sent when the 
queue size reaches integer j pending requests. 

Removing an Alert Definition 


No messages will be sent until the none option is given again with a 
different alert-type . This can be used to permanently stop further mes¬ 
sages from being sent. 

See Also 


lp(C), lpadmin(ADM), terminfo(F) 

Authorization 


"Die use of this utility is governed by assignment of the Ip authoriza¬ 
tion, which is usually reserved for system administrators. 


March 15, 1989 


LPFORMS-7 









LPSCHED (ADM) 


LPSCHED(ADM) 


Ipsched, Ipshut, Ipmove _ 

start/stop the print service and move requests 


Syntax 


/usr/lib/lpsched 
/usr/lib/Ipsched -q integer 
/usr/lib/lpsched -a integer 
/usr/lib/lpsched -p integer 
/usr/lib/lpsched -s integer 
/usr/lib/lpshut 

/usr/lib/lpmove requests dest 
/usr/lib/lpmove destl dest2 


Description 


Ipsched starts the LP print service; this can be done only by root or lp. 

Ipshut shuts down the print service. All printers that are printing at 
the time Ipshut is invoked will stop printing. When Ipsched is started 
again, requests that were printing at the time a printer was shut down 
will be reprinted from the beginning. 

Ipmove moves requests that were queued by lp between LP destina¬ 
tions. The first form of the command moves the named requests to the 
LP destination dest. Requests are request-ids as returned by lp. The 
second form moves all requests for destination destl to destination 
destl ; >P will then reject any new requests for destl. 

Note that when moving requests, Ipmove never checks the acceptance 
status (see accept (ADM)) of the new destination. Also, the request ID 
of the moved request is not changed so that users can still find their 
requests. The Ipmove command will not move requests that have 
options (content type, form required, and so on) that cannot be handled 
by the new destination. 

-q integer 

Specify the number of request structures you want to allocate. 

-a integer 

Specify the number of alert structures you want to allocate. By 
default, forty empty alert structures are allocated in addition to 
one for each printer or form on the system. Structures will , ^ 
always be allocated for existing printers and forms. You can 
choose, however, to have more or fewer than the forty extra, by 
using the -a option. For example, if you want only as many alert 
structures as you have printers and forms on your system, enter 
the following command: Ipsched -a 0. 
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-p integer 

Specify the number of print status structures you want to allo¬ 
cate. By default, twenty-five empty printer status structures are 
allocated in addition to one for each printer on the system. 
Structures will always be allocated for existing printers. You 
can choose, however, to have more or fewer than the forty extra 
by using the -p option. 

-s integer 

Specify the number of slow filters per printer that can be run 
simultaneously. 

Notes 


By default, the directory /usr/spool/lp is used to hold all the files used 
by the LP pnnt service. This can be changed by setting the SPOOL- 
DIR environment variable to another directory before running 
ipsched. If you do this, you should populate the directory with the 
same files and directories found under /usr/spool/lp; the LP print ser¬ 
vice will not automatically create them. Also, the SPOOLDIR vari¬ 
able must then be set before any of the other LP print service com¬ 
mands are run. 


Files 


/usr/spool/lp/* 

See Also 

enable(C), lp(C), Ipstat(C), accept(ADM), lpadmin(ADM) 

Authorization 

The behavior of this utility is affected by assignment of the Ip authori¬ 
zation, which is usually reserved for system administrators. 
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Ipsh _ 

menu driven Ip print service administration utility 

Syntax 

/usr/lib/sy sadm/lpsh 

Description 


Ipsh is the screen interface invoked by the sysadrnsh(.\DM) Printers 
selection to administer the print service. The interface performs all of 
the required lp print service functions that require system administra¬ 
tor authorization, lp. 

The program allows the administrator to perform any of the following 
tasks: 

• configure the LP print service to describe printers and devices. 

• administer filters to be used with the LP print service. 

• administer forms to be used with the LP print service. 

• start the LP print service. 

• shut down the LP print servee. 

• move print requests between printer destination. 

• cancel print requests. 

• allow destinations to accept or reject print requests. 

• set the printing queue priorities that can be assigned to jobs sub¬ 
mitted by users of the LP print service. 


• enable or disable printers. 

See Also 


auditsh(ADM), authsh(ADM), backupsh(ADM), 
sysadmsh(ADM), lp(C), lpadmin(ADM), 
lpforms(ADM), lpsched(ADM), lpusers(ADM), 
enable(C) 


atcronsh(ADM), 

lpfilter(ADM), 

accept(ADM), 
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Notes 


LPSH(ADM) 


Invoking the Ipsh directly is not recommended; use the sysadmsh 
Printers selection. 

Value Added 


Ipsh is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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ipusers _ 

set printing queue priorities 

Syntax 

/usr/lib/Ipusers -d priority-level 
/usr/lib/lpusers -q priority-level -u user-list 
/usr/lib/lpusers -u user-list 
/usr/lib/lpusers -q priority-level 

/usr/lib/lpusers -1 

Description 

The Ipusers command is used to set limits to the queue priority level 
that can be assigned to jobs submitted by users of the LP print service. 

The first form of the command (with -d) sets the system-wide priority 
default to priority-level, where priority-level is a value of 0 to 39 , with 
0 being the highest priority. If a user does not specify a priority level 
with a print request [see lp(C)], the default priority is used. Initially, 
the default priority level is 20. 

The second form of the command (with -q and -u) sets the default 
highest priority-level (0-39) that the users in user-list can request 
when submitting a print request. Users that have been given a limit 
cannot submit a print request with a higher priority level than the one 
assigned, nor can they change a request already submitted to have a 
higher priority. Any print requests with priority levels higher than 
allowed will be given the highest priority allowed. 

The third form of the command (with -u) removes the users from any 
explicit priority level and returns them to the default priority level. 

The fourth form of the command (with -q) sets the default highest 
priority level for all users not explicitly covered by the use of the 
second form of this command. 

The last form of the command (with - 1 ) lists the default priority level 
and the priority limits assigned to users. 

See Also 


lp(C) 
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majorsinuse __ 

displays the list of major device numbers currently 

specified in the mdevice file 

Syntax 


/etc/conf/cf.d/majorsinuse 

Description 


This script searches the mdevice file and displays a list of the major 
device numbers already in use. 

When installing a device driver with the Link Kit, you can use 
majorsinuse to find an available major device number for the driver. 
When you invoke the configure program to modify the system config¬ 
uration files with the new driver information, use the -m option to 
indicate the major device number of the driver. 

The -j option to configure performs a function similar to that of 
majorsinuse. If you give the -j option with the NEXTMAJOR keyword, 
configure tells you the next available major device number. 

Files 


/etc/conf/cf.d/mdevice 

See Also 


configure ADM), mdevice(F), “Adding Device Drivers with the Link 
Kit’ ’ in the System Administrator’s Guide 

Value Added 


majorsinuse is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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makekey _ 

generates an encryption key 

Syntax 

/usr/lib/makekey 

Description 

makekey improves the usefulness of encryption schemes by increasing 
the amount of time required to search the key space. It reads 10 bytes 
from its standard input, and writes 13 bytes on its standard output. 
The output depends on the input in a way that is intended to be diffi¬ 
cult to compute (i.e., to require a substantial fraction of a second). 

The first 8 input bytes (the input key) can be arbitrary ASCII charac¬ 
ters. The last 2 input bytes (the salt ) are best chosen from the set of 
digits, dot (.), slash (/), and uppercase and lowercase letters. The salt 
characters are repeated as the first 2 characters of the output. The 
remaining 11 output characters are chosen from the same set as the 
salt and constitute the output key . 

The transformation performed is essentially the following: the salt is 
used to select one of 4,096 cryptographic machines all based on the 
National Bureau of Standards DES algorithm, but broken in 4,096 dif¬ 
ferent ways. Using the input key as the key, a constant string is fed 
into the machine and recirculated. The 64 bits that come out are dis¬ 
tributed into the 66 output key bits in the result. 

See Also 


passwd(F) 
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mkdev _ 

calls scripts to add peripheral devices 


Syntax 


/etc/mkdev dos 
/etc/mkdev fd 
/etc/mkdev fs [ device file ] 

/etc/mkdev hd [ [ disk ] [ controller I adapter 1 ] f lun 1 

/etc/mkdev mouse J 

/etc/mkdev serial 

/etc/mkdev shl 

/etc/mkdev streams 

/etc/mkdev tape 

Description 


mkdev creates the device file(s) associated with a peripheral device. 
Based on the argument supplied, the mkdev command calls a script 
tound in the directoiy /usr/lib/mkdev. If no arguments are listed 
mkdev prints a usage message. I etc! mkdev dos I etc! mkdev dos initial- 

DOS n file e s S ystms eV1CeS conflgures the s y stem to support mounted 


I etc! mkdev M creates device files for use with a peripheral hard disk. 
The device files for an internal hard disk already exist, invokes the 
following utilities: ^ram(ADM), badtrk(ADM), fdisk{ ADM), and 
aivyy(ADM). mkdev hd includes an extended syntax for use on multi¬ 
ple controllers. These syntax extensions use numbers to refer to the 
disk and controller numbers. 


In addition, the codes ST506-, OMTI-, and SCSI- can be used to refer 
to the controller/adapter number, as shown in the tables below. 


ST506 disks will install with one of the following commands: 


mkdev hd 0 0 (or ST506-0) 
mkdev hd 1 0 (or ST506-0) 
mkdev hd 0 1 (or ST506-1) 
mkdev hd 1 1 (or ST506-1) 


first disk on first controller 
second disk on first controller 
first disk on second controller 
second disk on second controller 


first disk on controller (root disk) 
second disk on controller 


ESDI disks will install with one of the following commands: 

mkdev hd 0 0 (or OMTI-O) 
mkdev hd 1 0 (or OMTI-O) 
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SCSI disks require three pieces of information: the dnve number, the 
adapter number, and the lun (logical unit number). SCSI disks will 
install with one of the following commands: 

mkdev hd [0-7] [0-1] [0-7] 

mkdev hd [0-7] [SCSI-0 or SCSI-1] [0-7] 

mkdev hd must be invoked twice to install a SCSI disk. Thefirst time, 
the kernel will be reconfigured to support the new disk The second 
time, the disk will be initialized. Use the same mkdev hd arguments 
both times. 

letclmkdev serial creates device files for use with serial cards The 
device files for the first and second ports already exist. Additional 
device files must be created for the ports added when expansion cards 
are added to the system. 

letcl mkdev streams configures the kernel for streams support. 

letcl mkdev fs performs the system maintenance tasks required to add 
a new filesystem to the system once the device is created (mknod(C)) 
and the filesystem is made (mkfs{ ADM)). It creates the Ifde. and 
//i/e/lost+found directories, reserves slots m the lost+found directory, 
(if either already exist, they are used unmodified) and modifies 
/etc/checklist, /etc/default/filesys and /etc/default to check 
(fsck( ADM)) and mount (monnt(ADM), mnt(C), rc(C)) the filesystem 
as appropriate. It is usually used in conjunction with mkdev hd when 
adding a second hard disk to the system or with mkdev fd when creat¬ 
ing a mountable filesystem on a floppy, but can be used on any addi- 
tional filesystem (for example, on a large internal hard disk). 

letclmkdevfd creates bootable, root and filesystem floppy disks. 

Several floppies can be created during a single mkdev fd session, but 
mkdev does not display a prompt to remove the first floppy Mid insert 
the next one. Insert the next floppy when mkdev prompts Would you 
like to format the floppy first? (y/n).” 

letcl mkdev tape configures the tape driver in preparation for linking a 
new kernel that includes tape support. It adds a standard quarter-inch 
cartridge tape driver and/or a mini-cartridge tape driver. 

The current driver configurations can be displayed, and changed if 
necessary. A zero in any of the fields means the driver automatically 
detects the type of tape device installed and uses the built-in values 
for that device. If the autoconfiguration values are not correct tor your 
drive, refer to your hardware manual for the correct values, configure 
the driver and relink the new kernel, mkdev tape can also be used to 
remove a tape driver from the existing kernel. 
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SCSI tapes can also be installed using /mkdev hd. Just as with SCSI 
disks, the adapter and lun must be specified. 


I etc! mkdev shl initializes necessary devices and configures kernel 
parameters associated with the number of shell layers sessions avail¬ 
able on the system. 

I etc! mkdev mouse initializes necessary devices and configures the sys¬ 
tem to use any supported mouse. 

Once the driver is configured, you are prompted for re-linking the ker¬ 
nel. The appropriate devices in /dev are created. 

The various init scripts prompt for the information necessary to create 
the devices. 


Files 


/usr/lib/mkdev/* 

See Also 


badtrk(ADM), divvy(ADM), dparam(ADM), fd(HW), fdisk(ADM), 
filesys(F), format(C), hd(HW), lp(HW), mkfs(ADM), mknod(C), 
mount(ADM), serial(HW), usemouse(C), tape(HW) 

The System Administrator's Guide has chapters devoted to the instal¬ 
lation of most peripheral devices. 

Value Added 


mkdev is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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mkfs 


constructs a filesystem 


Syntax 

/etc/mkfs [ -y I -n ] [ -f fstype ] special blocks[: inodes] [gap inblocks] 
/etc/mkfs special proto [gap inblocks] 

XENIXfilesystem options 

[-s blocks [: inodes]] 

UNIXfilesystem options 

[-b blocksize] 

AFSfilesystem options 

[-c clustersize] 

Description 


mkfs constructs a file system by writing on the special file special , 
according to the directions found in the remainder of the command 
line, mkfs is actually a front-end that invokes the appropriate version 
of mkfs according to the filesystem type. The -f option specifies the 
filesystem type, which can be one of the following: 

AFS (Acer Fast Filesystem) 

S5 IK (UNIX) 

XENIX 

DOS 

The AFS is the default filesystem type. 

Standard Options 

If it appears that the special file contains a file system, operator con¬ 
firmation is requested before overwriting the data. The -y “yes” 
option overrides this, and writes over any existing data without ques¬ 
tion. The -n option causes mkfs to terminate without question if the 
target contains an existing file system. The check used is to read 
block one from the target device (block one is the super-block) and 
see whether the bytes are the same. If they are not, this is taken to be 
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meaningful data and confirmation is requested. 

If the second argument to mkfs is a string of digits, the size of the file 
system is the value of blocks interpreted as a decimal number. This is 
the number of physical (512-byte) disk blocks the file system will 
occupy. Jf the number of inodes is not given, the default is approxi¬ 
mately the number of logical blocks divided by 4. mkfs builds a file 
system with a single empty directory on it. The boot program block 
(block zero) is left uninitialized. 

If the second argument is the name of a file that can be opened, mkfs 
assumes it to be a prototype file proto, and will take its directions 
from that file. The prototype file contains tokens separated by spaces 
or new-hnes A sample prototype specification follows (line numbers 
have been added to aid in the explanation): 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 


/ s t and /diskboot 
4872 110 
d— 777 3 1 
usr d—777 

sh 
ken 

bO 

cO 

$ 


3 1 

-755 3 

d—755 6 
$ 

b—644 3 
c—644 3 


/bin/sh 


Line 1 in the example is the name of a file to be copied onto block 
zero as the bootstrap program. 

Line 2 specifies the number of physical (512-byte) blocks the file sys¬ 
tem is to occupy and the number of inodes in the file system. 

Lines 3-9 tell mkfs about files and directories to be included in this 
file system. 

Line 3 specifies the root directory. 

Lines 4-6 and 8-9 specify other directories and files. 

The $ on line 7 tells mkfs to end the branch of the file system it is on 
and continue from the next higher directory. The $ on lines 10 and 11 
end the process, since no additional specifications follow. 

File specifications give the mode, the user ID, the group ID, and the 
uutial contents of the file. Valid syntax for the contents field depends 
on the first character of the mode. F 

The mode for a file is specified by a 6-character string. The first char¬ 
acter specifies the type of the file. The character range is -bed to 
specify regular, block special, character special and directory files 
respectively. The second character of the mode is either u or - to 
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specify set-user-id mode or not. The third is g or - for the set-group-id 
mode. The rest of the mode is a 3-digit octal number giving the 
owner, group, and other read, write, execute permissions Lsee 

chmod( 1)]. 

Two decimal number tokens come after the mode; they specify the 
user and group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification may be a 
path name from which the contents and size are copied. It the tile is a 
block or character special file, two decimal numbers follow whic 
give the major and minor device numbers. If the file is a directory, 
mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. As 
noted above, the scan is terminated with the token $. 


The gap inblocks argument in both forms of the command specifies 
the rotational gap and the number of blocks/cylinder. 

XENIXfilesystem options _____ 

The -s option is a command-line override of the size and number of 
inodes in the proto file. 


UNIX filesystem options 


The -b blocksize option specifies the logical block size for the file sys¬ 
tem. The logical block size is the number of bytes read or written by 
the operating system in a single I/O operation. Valid values for block- 
size are 512, 1024, and 2048. The default is 1024. A block size of 
2048 may be chosen only if the 2K file system package is installed. If 
the -b option is used, it must appear last on the command line. 


AFS filesystem options 


The -C clustersize option specifies the cluster size for the filesystem 
This only applies to AFS; if this is included on the command line, the 
filesystem created will be AFS regardless of the other options used. 


Files 


/etc/vtoc/* 

See Also 


chmod(C), dir(F), filesystem(F) 
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Notes 


With a prototype file, it is not possible to copy in a file larger than 
64K bytes, nor is there a way to specify links. The maximum number 
of inodes configurable is 65500. 

The directory /etc/fscmd.d/7TPE contains programs for each file sys¬ 
tem type; mkfs invokes the appropriate binary. 
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mmdf _ 

routes mail locally and over any supported network 

Description 

The operating system uses MMDF (the Multi-channel Memorandum 
Distribution Facility) to route mail locally and over Micnet, UUCP, or 
other networks that provide MMDF support. The custom utility 
installs MMDF and configures a basic system for sending mail on a 
local machine. 

MMDF is a very versatile and configurable mail routing system. 
MMDF configuration begins with the /usr/mmdf/mmdftailor file, 
which defines the machine and domain names, the various tables 
(alias, domain, channel), and other configuration information. To 
change the configuration of MMDF on your system, you can log in as 
mmdf and edit the configuration files. Whenever you change MMDF 
alias or routing information in any way, you must rebuild the hashed 
database. 

Files 


/usr/mmdf/mmdftailor 

/usr/mmdf/table/alias.list 

/usr/mmdf/table/alias.user 

/usr/mmdf/table/* .chn 

/usr/mmdf/table/* .dom 

/usr/spool/mail/* 

/usr/spool/mmdf/... 

See Also 


dbmbuild(ADM), mmdfalias(ADM), mnlist(ADM), uulist(ADM), 
tables(F), mmdftailor(F), “Setting Up Electronic Mail” in the System 
Administrator’s Guide. 

Value Added 


mmdf is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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mmdfalias _ 

converts XENIX-style aliases file to MMDF format 

Syntax 


/usr/mmdf/table/tools/ mmdfalias 

Description 


mmdfalias is a conversion utility to produce MMDF-compatible alias 
files from the XENIX-format aliases file, mmdfalias also splits the 
converted contents of /usr/lib/mail/aliases into two MMDF files con¬ 
taining list-type aliases and aliases that map users to machines. 

After installing MMDF with custom, restore /usr/lib/mail/aliases from 
backup tape. Place the following line in the file to indicate where the 
list aliases end and the mapping aliases begin. 

# user-to-machine mapping 

Log in as mmdf and run the /usr/mmdf/table/tools/ mmdfalias conver¬ 
sion script from the /usr/mmdf/table directory. You now have two 
MMDF files, alias.list and alias.user, in the current directory. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. While logged in as mmdf, run dbmbuild from 

/usr/mmdf/table. 

Files 


/usr/lib/mail/aliases 

/usr/mmdf/table/alias.list 

/usr/mmdf/table/alias.user 

See Also 


dbmbuild(ADM), tables(F), “Setting Up Electronic Mail” in the Sys¬ 
tem Administrator’s Guide 

Value Added 


mmdfalias is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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mnlist _ 

converts a XENIX-style Micnet routing file to MMDF for¬ 

mat 

Syntax 

/usr/mmdf/table/tools/ mnlist 

Description 

mnlist is a conversion utility to produce MMDF-compatible Micnet 
routing files from the XENIX-format Micnet routing file. 

After installing MMDF with custom, restore /usr/lib/mail/top from 
backup media. Log in as mmdf and run the conversion script 
lusr/mmdf /table! tools/ mnlist from the /usr/mmdf/table directory. You 
now have a Micnet channel file, micnet.chn, in the current directory. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. While logged in as mmdf, run dbmbuild from 

/usr/mmdf/table. 

Files 


/usr/lib/mail/top 

/usr/mmdf/table/micnet.chn 

See Also 

dbmbuild(ADM), tables(F), “Setting Up Electronic Mail” in the Sys¬ 
tem Administrator’s Guide 

Value Added 

mnlist is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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mount _ 

mounts and unmounts a file structure 

Syntax 

/etc/mount [-r] [-f fstyp] special directory 
/etc/umount special-device 

Description 


mount announces to the system that a removable file structure is 
present on special-device. The file structure is mounted on directory. 
The directory must already exist; it becomes the name of the root of 
the newly mounted file structure, directory should be empty. If direc¬ 
tory contains files, they will appear to have been removed while the 
special-device is mounted and reappear when the special-device is 
unmounted. 

The mount and umount commands maintain a table of mounted de¬ 
vices. If mount is invoked without any arguments, it displays the 
name of each mounted device, and the directory on which it is 
mounted, whether the file structure is read-only, and the date it was 
mounted. 

The -f fstyp option indicates that fstyp is the file system type to be 
mounted. If this argument is omitted, it defaults to the root fstyp. 

The optional -r argument indicates that the file is to be mounted 
read-only. Physically write-protected file structures, such as floppy 
disks with write-protect tabs, must be mounted in this way or errors 
occur when access times are updated, whether or not any explicit 
write is attempted. 

umount removes the removable file structure on device special-de¬ 
vice. Any pending I/O for the file system is completed and the file 
structure is marked as clean. 

Files 


/etc/mnttab Mount table 

/etc/default/filesys Filesystem data 
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See Also 


MOUNT (ADM) 


umount(ADM), mnt(C), mount(S), mnttab(F), default(F), 
setmnt(ADM) 

Diagnostics 

mount issues a warning if directory does not match the s_fname field 
in the superblock of the filesystem to be mounted. The first six char¬ 
acters in the last component of directory are compared with the name 
in s_fname (i.e., mounting a filesystem named spool on /usr/spool 
won’t cause a warning message, but mounting the same filesystem on 
/mnt will.). 

Busy file structures cannot be dismounted with umount . A file struc¬ 
ture is busy if it contains an open file or some user’s working direc¬ 
tory. 

Notes 


Only the super-user can use the mount command. 

Some degree of validation is done on the file structure, however it is 
generally unwise to mount corrupt file structures. 

Be warned that when in single-user mode, the commands that look in 
/etc/mnttab for default arguments (for example df , ncheck , quot, 
mount , and umount) give either incorrect results (due to a corrupt 
/etc/mnttab from a non-shutdown stoppage) or no results (due to an 
empty mnttab from a shutdown stoppage). 

When multi-user, this is not a problem; the /etc/rc2 scripts initialize 
/etc/mnttab to contain only /dev/root and subsequent mounts update 
it appropriately. 

The mount (ADM) and umount (ADM) commands use a lock file to 
guarantee exclusive access to /etc/mnttab. The commands which just 
read it (those mentioned above) do not, so it is possible that they may 
hit a window, which is corrupt. This is not a problem in practice since 
mount and umount are not frequent operations. 

When mounting a file system on a floppy disk you need not use the 
same directory each time. However, if you do, the full pathnames for 
the files are consistent with each use. 
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Always unmount filesystems on floppy disks before removing them 
from the floppy drive. Failure to do so requires running fsck the next 
time the disk is mounted . 


The directory /etc/fscmd.d/7YP£ contains programs for each file sys¬ 
tem type; mownr/umount invokes the appropriate binary. 

Standards Conformance 


mount is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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mountall, umountall___ 

mount, unmount multiple file systems 

Syntax 

/etc/mountall [-] [filesystem-table ]... 

/etc/mountall [ -a ] 

/etc/umountall [ -k ] 

Description 

These commands can be executed only by the super-user. 

The mountall command is used to mount filesystems according to a 
filesystem-table, (/etc/default/filesys is the default filesystem table.) 
The special file name reads from the standard input. 

Before each file system is mounted, it is checked using fsstat( ADM) 
to see if it appears mountable. If the file system does not appear 
mountable, it is checked, using fsck( ADM), before the mount is 
attempted. 

mountall is called with the -a when the system autoboots. The -a flag 
causes output messages to be written to the file /etc/bootlog, and later 
mailed to the system administrator (see te(HW)). 

The umountall command causes all mounted file systems except root 
to be unmounted. 

Files 


Filesystem-table format: 

column 1 block special file name of filesystem 
column 2 mount-point directory 

column 3 “-r” if to be mounted read-only; “-d” if remote 

column 4 (optional) filesystem type string 
column 5+ ignored 

White space separates columns. Lines beginning with "#" are com¬ 
ments. Empty lines are ignored. 
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A typical filesystem-table might read: 
/dev/dsk/Osl /usr-rS51K 

See Also 


filesysCF)'*’ fsck(ADM) > f sstat(ADM), mount(ADM), signal(S), 


Diagnostics 


No messages are printed if the filesystems are mountable and clean. 
^moun r(ADM) 11 ^ messages come from /^(ADM), fsstat(ADM), and 


Notes 


The information displayed in Column 3 will only appear if the file sys¬ 
tem was mounted as a read-only or remote resource. 
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mvdir _ 

moves a directory 


Syntax 

/etc/mvdir dimame newdimame 


Description 


mvdir moves directories within a file system. The directoiy ( dir- 
name) must be a directory. If there is already a directory or file with 
the same name as name, mvdir fails. 


Neither name may be a sub-set of the other. For example, you cannot 
move a directory named hdy to /x/y/z, and vice versa. 


Notes 

You must be root to use mvdir. 


See Also 

mkdir(C) 

Standards Conformance _ 

mvdir is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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ncheck _ 

generates names from inode numbers 


Syntax 


ncheck [ -i numbers ] [ -a ] [ -s ] [ filesystem ] 

Description 


nf «n C rr Wlth n ° ar g um ent generates a pathname and inode number list 
ot all files on the set of file systems specified in /etc/mnttab. The two 
characters /. are appended to the names of directory files. 

The options are as follows: 


■i limits the report to only those files whose i-numbers follow. 

•a allows printing of the names . and ... which are ordinarily 


-s limits the report to special files and files with set-user-ID mode. 
Inis option may be used to detect violations of security policy. 

A single filesystem may be specified rather than the default list of 
mounted file systems. 

Files 

/etc/mnttab 

See Also 

fsck(ADM), sort(C) 


Diagnostics 


When the file system structure is improper, ?? denotes the “parent” 
ot a parentless file and a pathname beginning with ... denotes a loop. 
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Notes 


NCHECK(ADM) 


See Notes under mount( ADM). 

The directory /etc/fscmd.d/7YP£ contains programs for each file sys¬ 
tem type; ncheck invokes the appropnate binary. 
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netutil _ 

administers the micnet network 

Syntax 

netutil [option] [ -x ] [ -e ] 

Description 


The netutil command allows the user to create and maintain a network 
of UNIX machines. A Micnet network is a link through serial lines of 
two or more systems. It is used to send mail between systems with the 
mail (C) command, transfer files between systems with the rcp(C) 
command, and execute commands from a remote system with the 
remote (C) command. 

The netutil command is used to create and distribute the data files 
needed to implement the network. It is also used to start and stop the 
network. The option argument may be any one of install, save, 
restore, start, stop, or the numbers 1 through 5 respectively. The -x 
option logs transmissions and the -e options logs errors. The -x and -e 
options work only when they are used in conjunction with start, stop 
or their decimal equivalents (4 and 5). 

The install option interactively creates the data files needed to run the 
network. The save option saves these files on floppy or hard disks, 
allowing them to be distributed to the other systems in the network. If 
you save the micnet files to the hard disk, you can then use uucp(C) to 
transfer the files to the other machines. This option specifies the 
name of the backup device and prompts for whether this is the desired 
device to use. The user can specify an alternate device, including a 
file on the hard disk. The name of the default backup device is 
located in the file /etc/default/micnet. This can be changed depend¬ 
ing on system configuration. The restore option copies the data files 
from floppy disk back to a system. The start option starts the net¬ 
work. The stop option stops the network. An option may also be any 
decimal digit in the range 1 to 5. If invoked without an option, the 
command displays a menu from which to choose one. Once an option 
is selected, it prompts for additional information if needed. 

A network must be installed before it can be started. Installati on con¬ 
sists of creating appropriate configuration files with the install option. 
This option requires die name of each machine in the network, the 
serial lines to be used to connect the machines, the speed of transmis¬ 
sion for each line, and the names of the users on each machine. Once 
created, the files must be distributed to each computer in the network 
with the save and restore options. The network is started by using the 
start option on each machine in the network. Once started, mail and 
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remote commands can be passed along the network. A record of the 
transmissions between computers in a network can be kept in the net¬ 
work log files. Installation of the network is described in the System 
Administrator’s Guide. 


Files 

/bin/netutil 

/etc/default/micnet 

See Also 

mail(C), micnet(F), remote(C), rcp(C), systemid(F), top(F) 

Value Added 


netutil is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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nictable ___ 

process NIC database into channel/domain tables 

Syntax 


nictable -[CDT] [-d domain] [-s service] [-t transport] 

Description 


nictable is the tool responsible for taking the hosts.txt table supplied 
by the SRI Network Information Center and creating domain and 
channel tables. 

The -C option causes the program to generate a channel table on the 
standard output. The -D option creates a domain table. This option 
should be combined with the -d option explained below to state which 
domain table you are building. The -T option creates a “top” or 
‘rootdomain” table. No trailing domain spec is removed from the 
LHS entry. 

There are several options for further restricting the number of hosts 
chosen. The -d domain option states that only hosts in the domain 
specified should be output. An exception to this is when -d is com¬ 
bined with -T. In this case, all entries will be output EXCEPT for 
those in the domain specified. The intention is that you grap all of one 
domain with -D, and then grab everybody else with -T. The -s service 
option states that only hosts that are listed as supporting the service 
specified should be output. The -t transport option is like -s except it 
states that only hosts supporting the transport protocol specified 
should be considered. 

Typical usage involves two or three invocations: 


nictable -C < /etc/hosts.txt > smtpchannel 
nictable -D -d ARPA < /etc/hosts.txt > arpadomain 
(and optionally) 

nictable -T -d ARPA < /etc/hosts.txt > rootdomain 

Value Added 

nictable is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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nisadmin _ 

network listener service administration 


Syntax 

nisadmin -x 

nisadmin [ options ] net_spec 

Description 

nisadmin administers the network listener process(es) on a machine. 
Each network has a separate instance of the network listener process 
associated with it; each instance (and thus, each network) is config¬ 
ured separately. The listener process "listens" to the network for ser¬ 
vice requests, accepts requests when they arrive, and spawns servers 
in response to those service requests. The network listener process 
will work with any network (more precisely, with any transport pro¬ 
vider) that conforms to the transport provider specification. 

The listener supports two classes of service: a general listener ser¬ 
vice, serving processes on remote machines, and a terminal login ser¬ 
vice, for terminals connected directly to a network. The terminal log¬ 
in service provides networked access to this machine in a form suit¬ 
able for terminals connected directly to the network. However, this 
direct terminal service requires special associated software, and is 
only available with some networks (for example, the AT&T STARLAN 
network). 

nisadmin can establish a listener process for a given network, config¬ 
ure the specific attributes of that listener, and start and kill the listener 
process for that network, nisadmin can also report on the listener pro¬ 
cesses on a machine, either individually (per network) or collectively. 

The following list shows how to use nisadmin. In this list, net_spec 
represents a particular listener process. Specifically, net spec is the 
relative path name of the entry under /dev for a given network (that is, 
a transport provider). Changing the list of services provided by the 
listener produces immediate changes, while changing an address on 
which the listener listens has no effect until the listener is restarted. 
The following combination of options can be used. 

no options will give a brief usage message. 

. x will report the status of all of the listener processes 

installed on this machine. 


March 15, 1989 


NLSADMIN-1 










NLSADMIN (ADM) 


NLSADMIN (ADM) 


net_spec 


■q net_spec 


■v net_spec 


will print the status of the listener process for 
netjspec. 

will query the status of the listener process for the 
specified network, and will reflect the result of that 
query in its exit code. If a listener process is active, 
nlsadmin will exit with a status of 0; if no process is 
active, the exit code will be 1; the exit code will be 
greater than 1 in case of error. 

will print a verbose report on the servers associated 
with net_spec , giving the service code, status, com¬ 
mand, and comment for each. It also specifies the 
uid the server will run as, and the list of modules to 
be pushed, if any, before the server is started. 


■z service code net spec 

will print a report on the server associated with 
netjspec that has service code servicejsode, giving 
the same information as in the -v option. 


-q -z servicejcode net spec 

will query the status of the service with service code 
service code on network net_spec , and will exit 
with a status of 0 if that service is enabled, 1 if that 
service is disabled, and greater than 1 in case of 
error. 

-1 addr net_spec will change or set the address on which the listener 
listens (the general listener service). This is the 
address generally used by remote processes to 
access the servers available through this listener (see 
the -a option, below), addr is the transport address 
on which to listen and is interpreted using a syntax 
that allows for a variety of address formats. By 
default addr is interpreted as the symbolic ASCII 
representation of the transport address. An addr pre¬ 
ceded by a \x will let you enter an address in hexa¬ 
decimal notation. Note that addr must appear as a 
single word to the shell and must be quoted if it con¬ 
tains any blanks. 

If addr is just a dash (-), nlsadmin will report the 
address currently configured, instead of changing it. 

A change of address will not take effect until the 
next time the listener for that network is started. 

-t addr netjspec will change or set the address on which the listener 
listens for requests for terminal service, but is other¬ 
wise similar to the -I option above. A terminal ser¬ 
vice address should not be defined unless the appro- 
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■i net_spec 


[-m] -a service 


NLSADMIN (ADM) 

priate remote login software is available; if such 
software is available, it must be configured as ser¬ 
vice code 1 (see the -a option, below). 

will initialize or change a listener process for the 
network specified by net_spec\ that is, it will create 
and initialize the files required by the listener. Note 
that the listener should only be initialized once for a 
given network, and that doing so does not actually 
invoke the listener for that network. The listener 
must be initialized before assigning addressing or 
services. 

ode [-p modules] [-w id] -c and -y comment net_spec 
will add a new service to the list of services avail¬ 
able through the indicated listener. service_code is 
the code for the service, cmd is the command to be 
invoked in response to that service code, comprised 
of the full path name of the server and its arguments, 
and comment is a brief (free-form) description of the 
service for use in various reports. Note that cmd 
must appear as a single word to the shell, so if argu¬ 
ments are required, the cmd and its arguments must 
be surrounded by quotes. Similarly, the comment 
must also appear as a single word to the shell. When 
a service is added, it is initially enabled (see the -e 
and -d options below). 

If the -m option is specified, the entry will be 
marked as an administrative entry. Service codes 1 
through 100 are reserved for administrative entries, 
which are those that require special handling inter¬ 
nally. In particular, code 1 is assigned to the remote 
log in service, which is the service automatically 
invoked for connections to the terminal login 
address. 

The -m option used with the -a option indicates that 
special handlin g internally is required for those 
servers added with the -m set. This internal han¬ 
dling is in the form of code embedded on the listener 
process. 

If the -p option is specified, then modules will be 
interpreted as a list of STREAMS modules for the 
listener to push before starting the service being 
added. The modules are pushed in the order they are 
specified, modules should be a comma-separated 
list of modules, with no white space included. 
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If the -w option is specified, then id is interpreted as 
the user name from /etc/passwd that the listener 
should look up. From the user name, the listener 
should obtain the user ID, the group ID, and the 
home directory for use by the server. If -w is not 
specified, the default is to use the user ID listen. 

A service must explicitly be added to the listener for 
each network on which that service is to be avail¬ 
able. This operation will normally be performed 
only when the service is installed on a machine, or 
when populating the list of services for a new net¬ 
work. 

-r service_code net spec 

will remove the entry for the service_code from that 
listener’s list of services. This will normally be per¬ 
formed only in conjunction with the de-installation 
of a service from a machine. 

-e service code net spec 

-d service_code net spec 

will enable or disable (respectively) the service indi¬ 
cated by service code for the specified network. 
'Hie service must have previously been added to the 
listener for that network (see the -a option above). 
Disabling a service will cause subsequent service 
requests for that service to be denied, but the pro¬ 
cesses from any prior service requests that are still 
running will continue unaffected. 

-s net_spec 

-k net_spec will start and kill (respectively) the listener process 
for the indicated network. These operations will 
normally be performed as part of the system startup 
and shutdown procedures. Before a listener can be 
started for a particular network, it must first have 
been initialized, and an address must be defined for 
the general listener service (see the -i and -1 options, 
above). When a listener is killed, processes that are 
still running as a result of prior service requests will 
continue unaffected. 

The listener runs as user ID root, with group ID sys. A special ID, 
user ID listen and group ID adm, should be entered in the /etc/passwd 
file as a default ID for servers. The listener always uses as its home 
directory /usr/net/nls, which is concatenated with net_spec to deter¬ 
mine the location of the listener configuration information for each 
network. The home directory specified in the /etc/passwd entry for 
listener will used by servers that run as ID listen. 
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nlsadmin may be invoked by any user to generate reports, but all 
operations that affect a listener’s status or configuration are restricted 
to the super-user. 

Diagnostics ___ 

If the command is not run under the proper ro, an error message will 
be sent to standard error and the command will terminate. 

Files 

/vLST/net/nls/netjspec 

See Also 

Network Programmer’s Guide 
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profiler: prfld, prfstat, prfdc, prfsnap, 
prfpr 

UNIX system profiler 

Syntax 


/etc/prfld [ system_namelist ] 

/etc/prfstat on 
/etc/prfstat off 

/etc/prfdc file [ period [ off_hour ] ] 
/etc/prfsnap file 

/etc/prfpr file [ cutoff [ system_namelist ] ] 

Description 


The prfld, prfstat, prfdc, prfsnap, and prfpr routines form a system of 
programs to facilitate an activity study of the operating system. 

The prfld program is used to initialize the recording mechanism in the 
system. It generates a table containing the starting address of each 
system subroutine as extracted from system jiamelist. 

The prfstat program is used to enable or disable the sampling mecha¬ 
nism. Profiler overhead is less than 1% as calculated for 500 text 
addresses. Prfstat will also reveal the number of text addresses being 
measured. 

The prfdc and prfsnap programs perform the data collection function 
of the profiler by copying the current value of all the text address 
counters to a file where the data can be analyzed. Prfdc will store the 
counters into file every period minutes and will turn off at offjiour 
(valid values for offjiour are 0-24). Prfsnap collects data at the time 
of invocation only, appending the counter values to file. 

The prfpr program formats the data collected by prfdc or prfsnap. 
Each text address is converted to the nearest text symbol (as found in 
system jiamelist ) and is printed if the percent activity for that range is 
greater than cutoff. 

Files 


/dev/prf interface to profile data and text addresses 

/unix default for system namelist file 
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proto _ 

prototype job file for at, cron and batch 

Syntax 

/usr/lib/cron/.proto 

/usr/lib/cron/.proto.gueue 

Description 


When a job is submitted to at(C) or batch(C), the job is constructed as 
a shell script. First, a prologue is constructed, consisting of: 

• A header whether the job is an at job or a batch job (actually, at 
jobs submitted to all queues other than queue a, not just to the 
batch queue b, are listed as batch jobs); the header will be 

: at job 

for an at job, and 

: batch job 
for a batch job. 

• A set of Bourne shell commands to make the environment (see 
environ (5)) for the at job the same as the current environment; 

• A command to run the user’s shell (as specified by the SHELL 
environment variable) with the rest of the job file as input. 

At then reads a prototype file, and constructs the rest of the job file 
from it. 

Text from the prototype file is copied to the job file, except for special 
variables that are replaced by other text: 

$d is replaced by the current working directory 

$1 is replaced by the current file size limit (see ulimit( 2)) 

is replaced by the current umask (see umask( 2)) 

$t is replaced by the tune at which the job should be run, 
expressed as seconds since January 1, 1970, 00:00 Greenwich 
Mean Time, preceded by a colon 
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$< is replaced by text read by at from the standard input (that is, 
the commands provided to at to be run in the job) 

If die job is submitted in queue queue , at uses the file 
/usr/lib/cron/ .proto.queue as the prototype file if it exists, otherwise it 
will use the file /usr/lib/cron/.proto. 

Examples _ 

The standard .proto file supplied is: 

#ident "@ (#)adm:.proto 1.2" 

cd $d 
ulimit $1 
umask $m 
$< 

which causes commands to change the current directory in the job to 
the current directory at the time at was run, to change the file size 
limit in the job to the file size limit at the time at was run, and to 
change the umask in the job to the umask at the time at was run, to be 
inserted before the commands in the job. 

Files 


/usr/lib/cron/.proto 
/usr/lib/cron/.proto.q'Meue 

See Also 


at(C), sysadmsh(ADM), atcronsh(ADM) 
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rcO __ 

run commands performed to stop the operating sys¬ 

tem 

Syntax 

/etc/rcO 

Description 

This file is executed at each system state change that needs to have 
the system in an inactive state. It is responsible for those actions that 
bring the system to a quiescent state, traditionally called “shutdown.” 

One system state requires this procedure: state 0 (the system halt 
state). Whenever a change to this state occurs, the /etc/rcO procedure 
is run. The entry in /etc/inittab might read: 

sO:0:wait:/etc/rcO >/dev/console 2>&1 </dev/console 

Some of the actions performed by letc/rcO are earned out by files in 
the directory /etc/shutdown.d and files beginning with K in 
/etc/rcO.d. These files are executed in ASCII order (see Files below 
for more information), terminating some system service. The combi¬ 
nation of commands in /etc/rcO and files in /etc/shutdown.d and 
/etc/rcO.d determines how the system is shut down. 

The recommended sequence for /etc/rcO is: 

Stop System Services and Daemons. 

Various system services (such as Remote File Sharing or LP 
Spooler) are gracefully terminated. 

When new services are added that should be terminated when the 
system is shut down, the appropriate files are installed in 

/etc/shutdown.d and /etc/rcO.d. 

Terminate Processes 

SIGTERM signals are sent to all running processes by 
killall (ADM). Processes stop themselves cleanly if sent 
SIGTERM. 
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Kill Processes 

SIGKILL signals are sent to all remaining processes; no process 
can resist SIGKILL. 

At this point the only processes left are those associated with 
letdrcO and processes 0 and 1, which are special to the operating 
system. 

Unmount All File Systems 

Only the root file system (/) remains mounted. 

Files 


The execution by /bin/sh of any files in /etc/shutdown.d occurs in 
ASCII sort-sequence order. See rc2 (ADM) for more information. 

See Also 


killall(ADM), rc2(ADM), shutdown(ADM) 




March 15, 1989 


RCO-2 









RC2(ADM) 


RC2(ADM) 


rc2 __ 

run commands performed for multiuser environment 

Syntax 

/etc/rc2 

Description 

This file is executed via an entry in /etc/inittab and is responsible for 
those initializations that bring the system to a ready-to-use state, tradi¬ 
tionally state 2, called the "multiuser" state. 

The actions performed by letclrcl are found in files in several direc¬ 
tories and are executed in a prescribed order to ensure proper initiali - 
zation. Ietclrc2 performs the following functions in the order in which 
they appear: 

1. Runs the script letclconflbinlidmkenv . This script sets up the 
new kernel environment if a new kernel has been configured, 
calls idmkinit to rebuild the /etc/inittab file, and links files to 
the /etc/idrc.d and /etc/idsd.d directories to be run by Ietc/rc2. 

2. Runs the system setup scripts in the directory /etc/rc2.d. Some 
of the scripts in this directory are front-end scripts to run other 
scripts in the subdirectories of /etc/rc.d. 

3. Runs system setup scripts in the directory /etc/rc.d. This direc¬ 
tory exists for XENIX compatibility. It contains subdirectories 
named with the numerals 0 to 9. Each subdirectory contains 
scripts that perform certain system startup functions (for exam¬ 
ple, the directory /etc/rc.d/3 contains scripts that handle crash 
recovery). All of these scripts are run by the front-end scripts 
in /etc/rc2.d. Any other individual scripts in the directory are 
run. 

4. Runs the system setup scripts in the directory /etc/idrc.d, 
which contains scripts from the driver packages linked from 

/etc/conf/rc.d. 

5. Runs the scripts in /etc/idsd.d, which contains shutdown scripts 
linked from /etc/conf/sd.d. 

6. Runs the script /etc/rc. This script exists for XENIX compati¬ 
bility. It is an empty file, but you can add initialization com¬ 
mands to the file. These commands are run last during the ini¬ 
tialization. 
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The setup scripts are executed by /bin/sh in ASCII sort-sequence order 
(see Files for more information). When functions are added that need 

t( ? i wI ) en , the system goes multiuser, an appropriate file 

should be added in /etc/rc2.d. 

Other functions can be added, as required, to support the addition of 
hardware and software features. 

Examples 


The following are prototypical files found in /etc/rc2.d. These files 
are prefixed by an S and a number indicating the execution order of 
the files. 

MOUNTFSYS 


# Set up and mount file systems 
cd / 

/etc/mountall 


uucp 


# clean-up uucp locks, status, and temporary files 
rm -rf /usr/spool/locks/* 

letclrcl also sets certain environment variables, including the TZ vari¬ 
able by reading letcITIMEZONE, thus establishing the default 
environment for all commands that follow. 

Files 


Here are some hints about files in /etc/rc.d: 

The order in which files are executed is important. Since they are 
executed in ASCII sort-sequence order, the first character of the file 
name is a sequence indicator that helps keep the proper order. Thus, 
files starting with the following characters would run accordingly: 

[0-9] very early 
[A-Z] early 
[a-n] later 
[o-z] last 

Files in /etc/rc.d that begin with a dot (.) will not be executed. This 
feature can be used to hide files that are not to be executed for the 
time being without removing them. The command can be used only 
.by the super-user. 
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Files in /etc/rc2.d must begin with an S or a K followed by a number 
and the rest of the file name. Upon entering run level 2, files begin¬ 
ning with S are executed with the start option; files beginning with R 
are executed with the stop option. Files beginning with other charac¬ 
ters are ignored. 

See Also 

shutdown(ADM), init(M), “Starting and Stopping the System” 
chapter of the System Administrator’s Guide 
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reduce _ 

perform audit data analysis and reduction 

Syntax 


reduce [ -s session ] [ -p selection file ] 

Description 


reduce performs selective audit data reduction on compacted audit 
output files which were written by the audit daemon. Each audit 
record from the compaction files is examined during reduction to see 
if it meets the selectivity criteria established by the Audit Administra¬ 
tor. If so, the record is formatted and output to standard output. 

Reduction is performed on all files written by the audit daemon during 
a specified boot session. Each time the Audit subsystem is enabled 
and disabled, a new session number is generated and this is used to 
stamp the filenames generated during that session so that they are 
easily recognizable. The audit daemon records each filename that it 
writes compacted data to in a log file. The log file is always written to 
the secure directory, /tcb/files/audit. Each session log file is uniquely 
named with the prefix CAFLOG. followed by the session number. 
Thus by specifying a session number for reduction, reduce is able to 
locate the log file and read it to determine certain setup parameters 
and the list of input files to be reduced. 

Data is reduced based on a set of input selection criteria that governs 
the selection of records for printing. Records may be selected based on 
event types, time of event occurrence, user ID of record, group ID of 
record, or by specific object type. To selectively reduce, 
auditsh(ADM) is used to set up the audit selection file. This file is 
then specified to reduce upon invocation. Time interval selection 
allows for records to be selected only if they occurred within a certain 
time period. Event type selection allows records to be selected only if 
the specified event type is desired. Both user ID and group ID selec¬ 
tion allows records that were generated by certain users or groups to 
be selected. Lastly, object selection applies to those record types 
referring to a specific file. Some records refer to multiple files and a 
single match for those record types will result in the record being 
selected. Time and event type selection always takes precedence over 
user/group ID and object selection (e.g. if a record has an event type 
that is not selected but the user ID is, the record will be discarded). If 
a record is selected based on time and event type, if any of user ID, 
group ID, or object matches a field in the record, the record is 
selected. If only time and event types are specified, all records of 
matching event types in the interval are selected. If only event type 
selection is requested, all matching events are selected from every 
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record produced in that session, (e.g. If the event mask enables selec¬ 
tion for all events and no tune interval is specified, all records will be 
output) 

The format of the reduced data varies on the type of event being pro¬ 
cessed. Each record will include the process ID of the process being 
audited, the date and time of the event, the type of audit event, an 
indication of success or failure for the event, and if applicable, object 
names that were accessed. 

Items that are displayed for events include the following: 

Process ED The process ID of the process that generated the audit 


User IDs 

record. 

The login user ID, effective user ID, real user ID, 
effective group ID, and the real group ID are output for 
the process generating the audit record. 

Date/Time 

Each audit record is time stamped at generation time. 
The time value is formatted to produce a date/time 
string similar to that printed by ctime( S). 

Event Type 

Each audit record is classified into a certain event 
depending on what type of system call was performed 
or what type of action was taken by a trusted applica¬ 
tion. 

Action 

Many event types are broad categories into which cer¬ 
tain actions are classified. The reduction program 
makes use of other data in the record to provide further 
discrimination between process actions that fall into 
the category. For system calls, the actual system call 
audited is output. For applications, a more specific 
action identifier is provided. 

Object(s) 

Many events involve files or special devices which are 
classified as objects. The name of the objects affected 
by process actions are recorded for data reduction. 
Depending on the event and action type, some output 
records may include one or more object names. 

Modes 

For certain event types, the modes of a file or IPC 
object may be modified. For these records, the old and 
new values of the owner, group, and the object mode 
are displayed. 

Username 

Some events are user account oriented such as login 
and logoff as well as certain administrative functions. 
These output records include the username of the 
account that was responsible for the audited action. 
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Result 


See Also 


Each output record carries an indicator of whether the 
action was successful or not. Unsuccessful actions are 
sometimes more important that successful ones since 
they may indicate attempts to penetrate the system. For 
system calls that fail, the specific error number and 
error message is output. For applications, an error mes¬ 
sage describing the failure is output. 


auditsh(ADM), auditd(ADM), audit(HW), “Maintaining System 
Security,” chapter of the System Administrator’s Guide 


Diagnostics 

Upon successful completion, the program exits with status 0. 

Value Added 

reduce is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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relogin __ 

rename login entry to show current layer 


Syntax 

/usr/lib/layersys/ relogin [-s] [line] 

Description 

The relogin command changes the terminal line field of a user’s 
utmp{ F) entry to the name of the windowing terminal layer attached to 
standard input. write(C) messages sent to this user are directed to this 
layer. In addition, the who(C) command will show the user associated 
with this layer. The relogin command may only be invoked under 
layers(C). 

relogin is invoked automatically by layers{ C) to set the utmp( F) entry 
to the terminal line of the first layer created upon startup and to reset 
the utmp{ F) entry to the real line on termination. It may be invoked by 
a user to designate a different layer to receive write( C) messages. 

-s Suppress error messages. 

line Specifies which utmp{¥) entry to change. The utmp{ F) file 
is searched for an entry with the specified line field. That 
field is changed to the line associated with the standard 
input. To learn what lines are associated with a given user, 
say jdoe, enter: 

ps -f -u jdoe 

and note the values shown in the TTY field [see ps(C)]. 


Files 

/etc/utmp data base of users versus terminals 

Diagnostics 

Returns 0 upon successful completion, 1 otherwise. 
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See Also 
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layers(C), mesg(C), ps(C), who(C), write(C), utmp(F) 

Notes 

If line does not belong to the user issuing the relogin command or 
standard input is not associated with a terminal, relogin will fail. 
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removepkg _ 

remove installed package 

Syntax 

removepkg [software_package] 

Description 


The removepkg command will remove the AT&T-style software pack¬ 
age specified as an argument to removepkg or will remove the 
software package the user selects if no argument is given to remo¬ 
vepkg . 

If an argument is specified, removepkg will search the list of previ¬ 
ously installed packages and remove the first name it matchs. If no 
name is matched, the user is given an error message. 

If no argument is specified, removepkg will query the user, via a 
menu, which package to remove. 

Notes 


You must invoke removepkg on the console. 

This command does not work on packages installed with 
custom(ADM). 

See Also 


displaypkg(ADM), installpkg(ADM) 


March 15,1989 


REMOVEPKG-1 










RESTORE (ADM) 


RESTORE (ADM) 


restore __ 

UNIX incremental filesystem backup restore 

Syntax 

restore [ -c ] [ -i ] [ -o ] [ -t ] [ -d device ] [ pattern [pattern]... ] 

Description 


This utility acts as a front end to cpioiC), and thus reads cpio format 
tapes or floppies. This utility should only be used to restore backups 
made with the AT&T backup( ADM) utility, not xbackup(ADM). 

-c complete restore. All files on the tape are restored. 

-i gets the index file off of the medium. This only works when the 
archive was created using backup. The output is a list of all the 
files on the medium. No files are actually restored. 

-o overwrite existing files. If the file being restored already exists it 
will not be restored unless this option is specified. 

-t indicates that the tape device is to be used. MUST be used with 
the -d option when restoring from tape. 

-d <device> is the raw device to be used. It defaults to 
/dev/rdsk/f0ql5d (the 1.2M floppy). 

When doing a restore, one or more patterns can be specified. These 
patterns are matched against the files on the tape. When a match is 
found, the file is restored. Since backups are done using full path¬ 
names, the file is restored to its original directory. Metacharacters can 
be used to match multiple files. The patterns should be in quotes to 
prevent the characters from being expanded before they are passed to 
the command. If no patterns are specified, it defaults to restoring all 
files. If a pattern does not match any file on the tape, a message is 
printed. 


When end of medium is reached, the user is prompted for the next 
media. The user can exit at this point by entering “q”. (This may 
cause files to be corrupted if a file happens to span a medium.) In gen¬ 
eral, quitting in the middle is not a good idea. 

If the file already exists and an attempt is made to restore it without 
the -o option, the file name will be printed on the screen followed by a 
question mark. This file will not be restored. 


March 15, 1989 


RESTORE-1 








RESTORE (ADM) 


RESTORE (ADM) 


In order for multi-volume restores to work correctly, the raw device 
MUST be used. 

See Also 

sh(C) 
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rmail _ 

submit remote mail received via UUCP 

Syntax 

rmail user... 

Description 


rmail interprets incoming mail received via uucp(C), passing the pro¬ 
cessed mail on to submit (ADM) for processing by the MMDF mail 
syste®; r f ail is explicitly designed for use with UUCP and the 
MMDF submit program. It is not intended for use by regular users. 

Rmail performs several conversions on the incoming mail before cal¬ 
ling submit. The conversions change addresses from the UUCP rout¬ 
ing style (lists of hosts separated by the character T) to the domain 
style of address used within the MMDF mail system. The incoming 
message is dealt with in the following manner: 


1) The initial From (or “>From”) line is processed to discover the 
originating site and the sender of the message. Some UUCP 
mailers do not supply this information as part of the message body. 
Ir the originating site cannot be found from this information, the 
program environment is inspected for the variable “ACCTSYS”* 
is set to the originating system by some implementations of 
UUCP. The originating system is used as a table lookup value into 
the mmdf table rmail.chans,” the file contains site/channel pairs. 
Ir a match is found the resulting channel is used for the submit 
phase. The default UUCP channel is used if no match is found. 
1 he default channel name is specified in conf.c source and can be 
runtime tailored. Typically it is “uucp”. The existence of this 
channel is MANDATORY to prevent dropping mail from unknown 
hosts. 


2) The body of the message is inspected looking for any header lines 
containing addresses; the lines are “From:”, “To:”, “Cc:” 
“Bcc:” and “Sender:”. By scanning the address chains, the 
addresses in these lines are converted into “usei@known- 
site domain form using the MMDF tables to evaluate whether the 
mailer knows the site. For this to work properly, the unqualified 
name of all sites should exist in the appropriate domain tables. 
Ihe scanning stops when an unknown site is discovered and a com¬ 
posite address will be created. The “From:” line is treated spe¬ 
cially to preserve any comment information which may have been 
inserted by the originating mailer. 
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3) The ‘Date:’ line is also re-written into ARPA standard form. 

Before submit is called, the message is re-written into RFC822/733 
form with all addresses obeying the appropriate convention Any 
missing header lines are supplied. The destination address for the 
message is taken from the argument to rmail , and so the header re¬ 
writing which is done does not affect the routing of the message. 


See Also __ 

mail(C), uucp(C), submit(ADM) 
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routines _ 

finds driver entry points in a driver object module 

Syntax 

/etc/conf/cf.d/routines file.o ... 

Description 


routines searches each of the 
of routines used in the device 


specified object modules for the names 
driver and displays them on the screen 


This script is used when installing a device driver with the Link Kit. 
Write down the names produced by routines , then sort through the 
names to determine die interrupt priority level (the highest number 
ollowing the spl prefix) and the relevant configurable driver routines 
(the collection of routines with a common prefix and the suffixes 
open close, read, write, ioctl, startup, exit, fork, exec, init, halt, poll, 
strategy, print, Jty, or intr). F 

AVhen you invoke the configure program to modify the system config¬ 
uration files with the new driver information, you provide the interrupt 
priority level with the -1 option and the relevant routine names with 
the -a option. 

See Also 


configure^ADM), mdevice(F), “Adding Device Drivers with the Link 
Jvit in the System Administrator's Guide 


Value Added 


routines is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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runacct 


run daily accounting 

Syntax 


/usr/lib/acct/runacct [mmdd [state]] 

Description 


runacct is the main daily accounting shell procedure. It is normally 
initiated via cron( C). runacct processes connect, fee, disk, mid pro¬ 
cess accounting files. It also prepares summary files for prdaily or 
h illin g purposes, runacct is distributed only to source code licensees. 

runacct takes care not to damage active accounting files or summary 
files in the event of errors. It records its progress by writing descrip¬ 
tive diagnostic messages into active. When an error is detected, a 
message is written to /dev/console, mail [see mail(C)] is sent to 
root and adm, and runacct terminates, runacct uses a series ot lock 
files to protect against re-invocation. The files lock and lock! are 
used to prevent simultaneous invocation, and lastdate is used to 
prevent more than one invocation per day. 

runacct breaks its processing into separate, restartable states using 
statefile to remember the last state completed. It accomplishes this 
by writing the state name into statefile. runacct then looks in sta¬ 
tefile to see what it has done and to determine what to process next. 
States are executed in the following order: 


SETUP 

Move active accounting files into working files. 

WTMPFIX 

Verify integrity of wtmp file, correcting date 
changes if necessary. 

CONNECT 1 

Produce connect session records in ctmp.h format. 

CONNECT2 

Convert ctmp.h records into tacct.h format. 

PROCESS 

Conveit process accounting records into tacct.h 
format. 

MERGE 

Merge the connect and process accounting 
records. 

FEES 

Convert output of chargefee into tacct.h format 
and merge with connect and process accounting 
records. 
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Merge disk accounting records with connect, pro¬ 
cess, and fee accounting records. 

MERGETACCT 

Merge the daily total accounting records in day- 
tacct with the summary total accounting records 
in /usr/adm/acct/sum/tacct. 


CMS 

USEREXIT 

CLEANUP 


Produce command summaries. 

Any installation-dependent accounting programs 
can be included here. 

Cleanup temporary files and exit. 


To restart runacct after a failure, first check the active file for diagnos- 
tics, then fix up any corrupted data files such as pacct or wtmp. The 
lock files and lastdate file must be removed before runacct can be res¬ 
tarted. Ine argument mmdd is necessary if runacct is being restarted 
and specifies the month and day for which runacct will rerun the 
accounting. Entry point for processing is based on the contents of 
statenle, to override this, include the desired state on the command 
ime to designate where processing should begin. 


Examples 


To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» Aisr/adm/acct/nite/fd21og & 

Files 


/etc/wtmp 

/usr/adm/pacct * 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nite/lockl 

/usr/adm/acct/nite/lastdate 

Aisr/adm/acct/nite/state file 

/usr/adm/acct/nite/ptacct * .mmdd 
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acct(ADM), acctcms(ADM), acctcom(C) acctcon(ADM) 
acctmerg(ADM), acctprc(ADM), acctsh(ADM), cron(C), 
fwtmp(ADM), mail(C), acct(S), acct(F), utmp(F) 


Notes 


Normally, it is not a good idea to restart runacct in the SETUP state. 
Run SETUP manually and restart via: 


runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct file 
because it will not be complete. 

Standards Conformance 

runacct is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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sag _ 

system activity graph 

Syntax 

sag [ options ] 


Description 


The sag command graphically displays the system activity data stored 
in a binary data file by a previous sar (ADM) run. Any of the sar data 
items may be plotted singly, or in combination; as cross plots, or 
vereus tim e . Simple arithmetic combinations of data may be speci¬ 
fied. The sag command invokes sar and finds the desired data by 
string-maldiing the data column header (run sar to see what is avail¬ 
able). These options are passed through to sar: 

Select data later than time in the form hhf.mml. Default 
is 08:00. 

Select data up to time . Default is 18:00. 

Select data at intervals as close as possible to sec seconds. 

Use file as the data source for sar. Default is the current 
daily data file /usr/adm/sa/saJd. 

Other options : 


-s time 

-e time 
-i sec 
-ffile 


"T term Produce output suitable for terminal term. See tplot{ ADM) 
for known terminals. Default for term is $TERM. 

-x spec x axis specification with spec in the form: 

"name [op name]... [lo hi]" 


-y spec y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, e.g. 
r+w/s[dsk-l], or an integer value. Op is + - * or / surrounded by 
blanks. Up to five names may be specified. Parentheses are not recog¬ 
nized. Contrary to custom, + and - have precedence over 

* and /. Evaluation is left to right. Thus A / A + B * 100 is 
evaluated (A/(A+B))*100, andA + B/ C + Dis (A+B)/(C+D) Lo 
and hi are optional numeric scale limits. If unspecified, they are 
deduced from the data. 
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A single spec is permitted for the x axis. If unspecified, time is used 
Up to 5 spec’s separated by ; may be given for -y. Enclose the -x and 
-yarguments in " " if blanks or\<CR> are mcluded. The -y default is. 

-y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + %wio 0 100" 


Examples ___— 

To see today’s CPU utilization; 
sag 

To see activity over 15 minutes of all disk drives; 

TS=date +%H:%M 

sar -o tempfile 60 15 

TE=date +%H:%M . r , 

sag -f tempfile -s $TS -e $TE -y "r+w/s[dsk] 

Files 

/usr/adm/sa/sa dd daily data file for day del. 

See Also ___ 

sar(ADM), tplot(ADM) 
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sar, sal, sa2, sadc 

system activity report package 

Syntax 


sar [ -ubdycwaqvmnprDSAC ] [ -o file ] t [ n ] 

sar [-ubdycwaqvmnprDSAC] [-s time] [-e time] [-i sec] 
[-f file] 

/usr/lib/sa/sadc [t n] [ofile ] 

/usr/lib/sa/sal [t n] 

/usr/lib/sa/sa2 [-ubdycwaqvmnprDSAC] [-s time ] [-e time ] [-i sec ] 

Description 


sar , in the first instance, samples cumulative activity counters in the 
operating system at n intervals of t seconds, where t should be 5 or 
greater. If the -o option is specified, it saves the samples in file in 
binary format. The default value of n is 1. In the second instance, 
with no sampling interval specified, sar extracts data from a previ¬ 
ously recorded file , either the one specified by the -f option or, by 
default, the standard system activity daily data file /usr/adm/sa/sadd 
for the current day dd. The starting and ending times of the report can 
be bounded via the -s and -e time arguments of the form hh[:mm[:ss]]. 
The -i option selects records at sec second intervals. Otherwise, all 
intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

-u Report CPU utilization (the default): 

%usr, %sys, %wio, %idle - portion of time running in user 
mode, running in system mode, idle with some process waiting 
for block I/O, and otherwise idle. When used with -D, %sys is 
split into percent of time servicing requests from remote ma¬ 
chines (%sys remote) and all other system time (%sys local). 

-b Report buffer activity: 

bread/s, bwrit/s - transfers per second of data between system 
buffers and disk or other block devices; 
lread/s, lwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, i.e., (1-bread/lread) as a 
percentage; 

pread/s, pwrit/s - transfers via raw (physical) device mechanism. 
When used with -D, buffer caching is reported for locally- 
mounted remote resources. 
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-d Report activity for each block device, e. g., disk or tape drive. 
When data is displayed, the device specification dsk- is gen¬ 
erally used to represent a disk drive. The device specification 
used to represent a tape drive is machine dependent. The 
activity data reported is: 

%busy, avque - portion of time device was busy servicing a 
transfer request, average number of requests outstanding during 
that time; 

r+w/s, blks/s - number of data transfers from or to device, num¬ 
ber of bytes transferred in 512-byte units; 
avwait, avserv - average time in ms. that transfer requests wait 
idly on queue, and average time to be serviced (which for disks 
includes seek, rotational latency, and data transfer times). 

-n Report name cache statistics. The activity reported is: 
c_hits, cmisses - number of name cache hits and misses; 
hit% - the hit ratio as a percentage. 

-y Report TTY device activity: 

rawch/s, canch/s, outch/s - input character rate, input character 
rate processed by canon, output character rate; 
rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem inter¬ 
rupt rates. 

-c Report system calls: 

scall/s - system calls of all types; 
sread/s, swrit/s, fork/s, exec/s - specific system calls; 
rchar/s, wchar/s - characters transferred by read and write sys¬ 
tem calls. When used with -D, the system calls are split into 
incoming, outgoing, and strictly local calls. 

-w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s - number of transfers and 
number of 512-byte units transferred for swapins and swapouts 
(including initial loading of some programs); 
pswch/s - process switches. 

-a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

-q Report average queue length while occupied, and % of time 
occupied: 

runq-sz, %runocc - run queue of processes in memory and runn¬ 
able; 

swpq-sz, %swpocc - swap queue of processes swapped out but 
ready to run. 

-v Report status of process, inode, file tables: 

text-sz, proc-sz, inod-sz, file-sz, lock-sz - entries/size for each 
table, evaluated once at sampling point; 

ov - overflows that occur between sampling points for each 
table. 
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-m Report message and semaphore activities: 
msg/s, sema/s - primitives per second. 

-p Report paging activities: 

vflt/s - address translation page faults (valid page not in mem¬ 
ory); 

pflt/s - page faults from protection errors (illegal access to page) 
or "copy-on-writes"; 

pgfil/s - vflt/s satisfied by page-in from file system; 
rclm/s - valid pages reclaimed for free list. 

-r Report unused memory pages and disk blocks: 

freemem - average pages available to user processes; 
frees wap - disk blocks available for process swapping. 

-D Report Remote File Sharing activity: 

When used in combination with -u, -b, or -c, it causes sar to 
produce the remote file sharing version of the corresponding 
report. -Du is assumed when only -D is specified. 

-S Report server and request queue status: 

Average number of Remote File Sharing servers on the system 
(serv/lo-hi), % of time receive descriptors are on the request 
queue (request %busy), average number of receive descriptors 
waiting for service when queue is occupied (request avg lgth), 
% of time there are idle servers (server %avail), average number 
of idle servers when idle ones exist (server avg avail). 

-A Report all data. Equivalent to -udqbwcayvmprSDC. 

-C Report Remote File Sharing buffer caching overhead: 

snd-inv/s - number of invalidation messages per second sent by 
your machine as a server. 

snd-msg/s - total outgoing RFS messages sent per second, 
rcv-inv/s - number of invalidation messages received from the 
remote server. 

rcv-msg/s - total number of incoming RFS messages received 
per second. 

dis-bread/s - number of buffer reads that would be eligible for 
caching if caching were not turned off. (Indicates the penalty of 
running uncached.) 

blk-inv/s - number of buffers removed from the client cache. 


Examples 

To see today’s CPU activity so far: 
sar 
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To watch CPU activity evolve for 10 minutes and save data: 
sar -o temp 60 10 

To later review disk and tape activity from that period: 
sar -d -f temp 


Data Gathering 

The operating system contains several counters that are incremented 
as various system actions occur. These include counters for CPU utili¬ 
zation, buffer usage, disk and tape I/O activity, TTY device activity, 
switching and system-call activity, file-access, queue activity, inter¬ 
process communications, paging, and Remote File Sharing. 

sadc and shell procedures, sal and sa2, are used to sample, save, and 
process this data. 

sadc, the data collector, samples system data n times, with an interval 
of t seconds between samples, and writes in binary format to ofile or to 
standard output. The sampling interval t should be greater than 5 
seconds; otherwise, the activity of sadc itself may affect the sample. 
If t and n are omitted, a special record is written. This facility is used 
at system boot time, when booting to a multiuser state, to mark the 
time at which the counters restart from zero. For example, the 
/etc/init.d/perf file writes the restart mark to the daily data by the 
command entry: 

su sys -c "/usr/lib/sa/sadc /usr/adm/sa/sadate +%d" 

The shell script sal , a variant of sadc, is used to collect and store data 
in binary file /usr/adm/sa/sadc/ where dd is the current day. The argu¬ 
ments t and n cause records to be written n times at an interval of t 
seconds, or once if omitted. The entries in 
/usr/spool/cron/crontabs/sys [see cron(C)]: 

0 * * * 0-6 /usr/lib/sa/sal 
20,40 8-17 * * 1-5 /usr/lib/sa/sal 

will produce records every 20 minutes during working hours and 
hourly otherwise. 

The shell script sa2, a variant of sar writes a daily report in file 
/usr/adm/sa/sardd. The /usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A 


will report important activities hourly during the working day. 


September 24,1990 


SAR-4 







SAR(ADM) 


SAR(ADM) 


The structure of the binary daily data file is: 


struct sa { 

struct sysinfo si, 
struct minfo mi; 
struct dinfo di; 
struct rcinfo rc; 
struct bpbinfo bij 
int bpbjutilize 
int minserve. 


int 

szinode; 

/* 

int 

szfile; 

/* 

int 

szproc; 

/* 

int 

szlckf; 

/* 

int 

szlckr; 

/♦ 

int 

mszinode; 

/* 

int 

mszfile; 

/* 

int 

ms 2 proc; 

/* 

int 

mszlckf; 

/* 

int 

mszlckr; 

/* 

long 

inodeovf; 

/* 

long 

fileovf; 

/* 

long 

prooovf; 

/* 

time t ts; 

/* 

long 

devio[r©EVS] [4]; 


/* see /usr/include/sys/sysinfo. h */ 

/* defined in sys/sysinfo.h */ 

/* RFS info defined in sys/sysinfo.h */ 

/* Client cache info defined in sys/sysinfo.h */ 
/* Co-processor info defined in sys/sysinfo.h */ 
/* Co-prooessor utilize flag */ 

/* RFS server low and high water marks */ 
nt size of inode table */ 
nt size of file table */ 


! */ 

*/ 

V 


int 

int 

♦define I0_CPS 
♦define io_bcot 
♦ define lojci 
♦define io_resp 
); 


^ */ 

*/ 


/* device unit information */ 
cachehits;/* nurber of name cache hits */ 
cachemisses; /* nurber of name cache misses */ 

0 /* curulative I/O requests */ 

1 /* curulative blocks transferred */ 

2 /* cumulative drive busy time in ticks */ 

3 /* curulative I/O resp time in ticks */ 


Files 


/usr/adm/sa/sa dd 
/usr/adm/sa/sardd 
/tmp/sa .adrfl 


daily data file 
daily report file 
address file 


Notes 


Output files created with this version of sar cannot be interpreted by 
earlier versions. However, this version interprets older output files 
correctly. 

See Also 


cron(C), sag(ADM), timex(ADM) 

Standards Conformance 


sal, sa2, sadc and sar are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 
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schedule 

database for automated system backups 


Description 

The schedule database is used in conjunction with fsphoto ( ADM) to 
partially automate system-wide backups. For each filesystem to be 
backed-up, a cyclical schedule of xbackup (ADM) or cpio (C) levels is 
specified, (fsphoto uses cpio( C) or xbackup{ ADM), for XENIX or for 
UNIX filesystems, respectively.) 

This cyclical schedule (or cycle) is a list of dump levels to perform 
(including no dump at all) and a pointer to the last-used element of 
that list. The pointer is advanced to the next element of the list on a 
regular basis (each time fsphoto is run, usually once per day), starting 
at the beginning of the list each time it falls off the end. It is 
advanced, however, only on success - the desired dump must have 
been successful. 

Each entry in the file is on a separate line. Blank and comment lines 
(beginning with “#”) may be placed anywhere. Several keywords are 
recognized: 

site sitename 

Sitename is passed to fsave as a description to place on each tape 
label. Usually, sitename is the name of the company or a building 
number. 

media drive k sizes ... [format] 

Device drive is a floppy capable of handling volumes with any of 
the listed sizes (in kilobytes). If specified, format is the UNIX com¬ 
mand used to format the described floppies. This also applies to 
standard cartridge tapes. 

media drive d density sizes ... [format ] 

Device drive is a density BPI magtape capable of handling tapes of 
any of the indicated sizes (in feet). Like floppies, format is the 
optional UNIX command used to format the described tape. 

[0-9] size savetime importance marker 

Description of each dump level, as described in fsave (ADM). The 
defaults are: 


Level 

Size 

Savetime 

Importance 

Marker 

0 

- 

"1 year” 

critical 

none 

1 

- 

"3 months” 

necessary 

none 

2...1 

- 

”1 month” 

important 

none 

8 

- 

"2 weeks” 

useful 

none 

9 

- 

”1 week" 

precautionary 

none 
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All four fields must be specified. A size of - means to use the first size 
listed in the appropriate media sizes list. 

Keywords should be placed before any filesystem dump schedules. A 
filesystem dump schedule is of the form: 

/dev/rfilesys cycle 

The filesystem resident on device /dev/filesys is to be backed-up 
according to cycle , which is a space-separated list of dump levels 
(the digits 0 to 9, passed to dump), or the letter x, meaning no 
dump should occur. 

A dump cycle must have at least one member, but it may be of any 
length. Different filesystems may have cycles of different lengths. 

Here is a sample schedule file: 

# SYSTEM BACKUP SCHEDULE 
site mymachine 


# Media Entries 


# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 


96 tpi 1.2 MB floppy 0 

media /dev/rfd096dsl5 k 1200 format /dev/rfd096dsl5 
96 tpi 1.2 MB floppy 1 

media /dev/rfdl96dsl5 k 1200 format /dev/rfdl96dsl5 
Cartridge tape 0 

media /dev/rctO k 60000 125000 150000 tape erase 
9-track tape drive 

media /dev/rmtO d 1600 2400 1200 600 


Backup Descriptor Table 
Backup Vol. Save for 

Vitality 

Label 

level 

size 

how long 

(importance) 

marker 

0 

- 

"1 year" 

critical 

"a red sticker" 

1 

- 

"4 months" 

necessary 

"a yellow sticker 

8 

- 

"3 weeks" 

useful 

"a blue sticker" 

9 

- 

"1 week" 

precautionary 

none 


# Schedule Table 

# 12345 67890 12345 67890 

# Filesystem MTWTF MTWTF MTWTF MTWTF Method 

/dev/rroot 0x9x9 8x9x9 1x9x9 8x9x9 cpio 

/dev/ru 90999 98999 91999 98999 cpio 


In the example above, filesystem /dev/rroot is dumped using a level 0 
dump the first time fsphoto is run (on a Monday), and if that dump is 
successful, the next (second) time it runs (Tbesday), no dump is per¬ 
formed. If doing nothing is successful, the third time run (Wednesday) 
a level 9 dump occurs. If that dump succeeds, no dump occurs the 
fourth time (Thursday), but the fifth time fsphoto is run (Friday), a 
level 9 dump is made. 
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Each time a successful dump at the specified level happens, the 
pointer advances so that the next run of fsphoto (on the next weekday) 
will do the next dump scheduled for that filesystem. If however, a 
dump fails (or is interrupted or postponed by the operator) the pointer 
is not advanced; hence, the next time fsphoto is attempted, the same 
level dump will again be tried so the sequence will not be broken (but 
the timing may be off). 

Continuing the example, the nineteenth time fsphoto runs, a level 9 
dump of/dev/rroot is done, no dump is performed the next (twentieth) 
time, but the twenty-first time (Monday of every fifth week) the cycle 
starts over again at the beginning with a level 0 dump. 

The larger and more rapidly changing filesystems /dev/ru is dumped 
more frequently (each time fsphoto is run - once a day - instead of 
every other time), and the levels used are staggered to prevent having 
to perform two full-scale dumps (like levels 0 or 1) of the large 
filesystems on the same day. The backup cycle period is also shorter, 
two weeks instead of four. 

The Method field defines the backup utility to be used, cpio works for 
both XENIX and UNIX filesystems, but xbackup works only on XENIX 
filesystems. 

See Also 


fsphoto(ADM), fsave(ADM), xbackup(ADM) 


Notes 


Keywords and filesystem names must not be preceded by any spaces 
or tabs. 

It is not necessary to specify the name of the “raw” (/dev/r*) device 
for each filesystem, but the backups are faster if this is done. 


Value Added 

schedule is an extension of AT&T System V provided by The Santa 
Cruz Operation, Inc. 
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setclock _ 

sets the system real-time (time of day) clock 

Syntax 

setclock [ time ] 

Description 

The setclock file sets the battery-powered, real-time time of day clock 
to the given time. If time is not given, the current contents of the 
battery-powered clock are displayed. The time must be a combination 
of digits with the form: 

MMddhhmmyy 

where MM is the month, dd is the day, hh is the hour, mm is the 
minute, and yy is the last two digits of the year. If yy is not given, it is 
taken from the current system time. For example, the command: 

082615035 

sets the time of day clock to 15:03 on August 26,1985. 

Files 

/etc/setclock 

See Also 

clock(F) 

Notes 

Not all computers have battery-powered real-time time of day clocks. 
Reier to your computer’s hardware reference manual. 


Value Added 


setclock is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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setmnt 


establishes /etc/mnttab table 


Syntax 


/etc/setmnt 


Description 



setmnt creates the /etc/mnttab table (see mnttab ( F)), which is needed 
for both the mounfi ADM) and umount (ADM) commands, setmnt 
reads the standard input and creates a mnttab entry for each lme. 
Input lines have the format: 

filesys node 

where filesys is the name of the file system’s special file (e.g., ‘‘hdO”) 
and node is the root name of that file system. Thus, filesys and node 
become the first two strings in the mnttab (F) entry. 


Files 

/etc/mnttab 

See Also 

mnttab(F) 

Notes ___ .. 

If filesys or node are longer than 128 characters, errors can occur. 

setmnt silently enforces an upper limit on the maximum number of 
mnttab entries. 

setmnt is normally invoked by the /etc/rc2 scripts when the system 
boots up. 
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settime __ 

changes the access and modification dates of files 

Syntax 

settime mmddhhmm [ yy ] [ -f fname ] name ... 

Description 


Sets the access and modification dates for one or more files. The 
dates are set to the specified date, or to the access and modification 
dates of the file specified via -f. Exactly one of these methods must 
be used to specify the new date(s). The first mm is the month number: 
da is the day number in the month; hh is the hour number (24 hour sys¬ 
tem); the second mm is the minute number; yy is the last two digits of 
the year and is optional. For example: 

settime 1008004583 ralph pete 


w c ?“ 311(1 m °dification dates of files ralph and pete to Oct 8, 
12:45 AM, 1983. Another example: 

settime -f ralph john 


This sets the access and modification dates of the file john to those of 
the file ralph. 

Notes 


Use of touch in place of settime is encouraged. 
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sfmt __ 

performs special formatting 


Syntax 

/etc/sfmt device name 

Description 

The sfmt command performs a low-level formatting, initializes non¬ 
standard disk parameters, and performs initial processing of manufac¬ 
turer-supplied defect lists of the disk device jiame. device name 
should be the character-special device representmg the whole disk, tor 
example, /dev/rhdOO. 

Use sfmt only if the ‘ ‘type=E’ ’ banner appears during power-up. If the 
banner does not appear, follow the instructions provided m the Instal- 
lation Guide. 

Low-level disk formatting is usually performed on bundled systems 
before delivery. If this formatting has not been done, you must format 
the disk before installing it. You must know the hard disk parameters 
before you invoke sfmt. 

Files 


/dev/rhd?0 

Value Added 


sfmt is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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shutdown 

terminates all processing 

Syntax 

/etc/shutdown [ -y ] [ -g[hh:]mm ] [ -i[0156sS] ] [ -f ’mesg" ] [ -fFELE ] 
[su] 

Description 


The primary function of shutdown is to terminate all currently running 
processes in an orderly and cautious manner, shutdown goes through 
the following steps: 

1. All users logged on the system are notified to log off the system 
by a broadcasted message. 

2. /etc/init is called to perform the the actual shutdown. 

Only the super-user can execute the shutdown command. 

The options are as follows: 

-y Runs the command silently. If this option is not 

specified, shutdown will prompt for confirmation to 
shut down the system. 

-g[hh:]mm Specifies the number of hours and minutes before 
shutdown (maximum: 72 hours). 60 seconds is the 
default. (To shut down the system immediately 
without a grace period, use /etc/haltsys or 
/etc/reboot). 

-i[0156sS] Specifies the init level to bring the system to (see 
init( M)). By default, the system is brought to level 0. 

-fmesg mesg is a message enclosed in double quotes ("") to 
be sent to all terminals warning of the imminent 
shutdown during the grace period. 

-fFILE Similar to the -fmesg option, but FILE is the path¬ 
name for a file containing the message. 
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The optional su argument lets the user go single-user, without com¬ 
pletely shutting down the system (this option is identical to -il and is 
present for backwards compatibility with XENIX). Broadcast mes¬ 
sages, whether default or defined, are displayed at regular intervals 
during the grace period. The closer the shutdown time, the more fre¬ 
quent the message: 


Time left until shutdown 

Frequency of message 

Greater than 1 hour 
Greater than 15 minutes 
Less than 15 minutes 

Every hour 

Every 15 minutes 

Every minute 


In general, if no. options are specified, shutdown behaves as follows: 

1. Prompt for confirmation 

2. 60-second grace period 

3. Bring the system to init level 0 

4. Broadcast default message prior to shutdown. 

See Also 


wall(ADM), boot(HW) 

Diagnostics 


The most common error diagnostic that will occur is device busy. 
This diagnostic appears when a particular file system could not be 
unmounted. See umount(ADM). 

Notes 


Once shutdown has been invoked, it must be allowed to run to comple¬ 
tion and must not be interrupted by pressing BREAK or DEL. 

shutdown does not work when executed from within a shell layer. 

shutdown locks the hard disk heads. 

shutdown was developed at the University of California, Berkeley, and 
is used with permission. 
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strace _ 

prints STREAMS trace messages 

Syntax 


strace [ mid sid level ]... 

Description 


strace without arguments writes all STREAMS event trace messages 
from all drivers and modules to its standard output. These messages 
are obtained from the STREAMS log driver [/tfg(M)]. If arguments are 
provided they must be in triplets of the form mid, sid , level, where mid 
is a STREAMS module id number, sid is a sub-id number, and level is a 
tracing priority level. Each triplet indicates that tracing messages are 
to be received from the given module/dnver, sub-id (usually indicat¬ 
ing minor device), and priority level equal to or less than the given 
level. The token all may be used for any member to indicate no re¬ 
striction for that attribute. 

The format of each trace message output is: 

<seq> <time> <ticks> <level> <flags> <mid> <sid> <text> 


<seq> 

trace sequence number 

<time> 

time of message in hh:mm:ss 

<ticks> 

time of message in machine ticks since boot 

<level> 

tracing priority level 

<flags> 

E : message is also in the error log 

F : indicates a fatal error 

N : mail was sent to the system administrator 

<mid> 

module id number of source 

<sid> 

sub-id number of source 

<text> 

formatted text of the trace message 


Once initiated, strace will continue to execute until terminated by the 
user. 
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STRACE(ADM) 


Output all trace messages from the module or driver whose module id 
is 41: 

strace 41 all all 

Output those trace messages from driver/module id 41 with sub-ids 0, 
l,or2: 

strace 410 1 4111 412 0 

Messages from sub-ids 0 and 1 must have a tracing level less than or 
equal to 1. Those from sub-id 2 must have a tracing level of 0. 

See Also 


log(M), STREAMS Programmer's Guide 

Diagnostics 

Due to performance considerations, only one strace process is permit¬ 
ted to open the STREAMS log driver at a time. The log driver has a 
list of the triplets specified in the command invocation, and compares 
each potential trace message against this fist to decide if it should be 
formatted and sent up to the strace process. Hence, long lists of tri¬ 
plets will have a greater impact on overall STREAMS performance. 
Running strace will have the most impact on the timing of the 
modules and drivers generating the trace messages that are sent to the 
strace process. If trace messages are generated faster than the strace 
process can handle them, then some of the messages will be lost. This 
last case can be determined by examining the sequence numbers on 
the trace messages output. 
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strclean _ 

STREAMS error logger cleanup program 

^ Syntax 

strclean [ -d logdir ] [-a age ] 


Description 


strclean is used to clean up the STREAMS error logger directory on a 
regular basis (for example, by using cron{ C)). By default, all files 
with names matching error.* in /usr/adm/streams that have not been 
modified in the last 3 days are removed. A directory other than 
/usr/adm/streams can be specified using the -d option. The max¬ 
imum age in days for a log file can be changed using the -a option. 

Example 


strclean -d /usr/adm/streams -a 3 

has the same result as running strclean with no arguments. 


Notes 

strclean is typically run from cron{ C) on a daily or weekly basis. 

Files 

/usr/adm/streams/error. * 

See Also 


cron(C), strerr(ADM), STREAMS Programmer's Guide 
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strerr _ 

STREAMS error logger daemon 


Syntax 


strerr 


Description ___ 

strerr receives error log messages from the STREAMS log driver 
[/og(M)] and appends them to a log file. The error log files produced 
reside in the directory /usr/adm/streams, and are named error .mm- 
dd, where mm is the month and dd is the day of the messages con¬ 
tained in each log file. 

The format of an error log message is: 

<seq> <time> <ticks> <flags> <mid> <sid> <text> 


<seq> 

error sequence number 

<time> 

time of message in hh:mm:ss 

<ticks> 

time of message in machine ticks since boot priority 
level 

<flags> 

T: the message was also sent to a tracing process 

F : indicates a fatal error 

N : send mail to the system administrator 

<mid> 

module id number of source 

<sid> 

sub-id number of source 

<text> 

formatted text of the error message 


Messages that appear in the error log are intended to report excep¬ 
tional conditions that require the attention of the system administrator. 
Those messages which indicate the total failure of a STREAMS driver 
or module should have the F flag set. Those messages requiring the 
immpHiatp attention of the administrator will have the N flag set, 
which causes the error logger to send the message to the system 
administrator via mail(C). The priority level usually has no meaning 
in the error log but will have meaning if the message is also sent to a 
tracer process. 
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Once initiated, strerr will continue to execute until terminated by the 
user. Commonly, strerr would be executed asynchronously. 

Notes 


Only one strerr process at a time is permitted to open the STREAMS 
log driver. 

If a module or driver is generating a large number of error messages, 
running the error logger will cause a degradation in STREAMS perfor¬ 
mance. If a large burst of messages are generated in a short time, the 
log driver may not be able to deliver some of the messages. This 
situation is indicated by gaps in the sequence numbering of the mes¬ 
sages m the log files. 

Files 


/usr/adm/streams/error./ww-cW 

See Also 


log(M), STREAMS Programmer's Guide 
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submit _ 

MMDF mail enqueuer 


Syntax 


submit [-L...*V...*Wbcdf...*g...*hi...*jk...*lmnqrstuvwxyz] 

Description 


All mail is entered into the MMDF mail transport environment 
through the submit program. This document is intended to provide the 
specific information needed to control submit. While it can be called 
directly from a user’s terminal, access to submit is most conveniently 
done through a program such as mail(C). It also will be useful to read 
replies(M), which describes reply values. 


Basic Modes 

submit permits considerable flexibility with respect to batching multi¬ 
ple submissions, response and error handling, and address source spe¬ 
cification. 


Multiple Submissions 

1 Terminate after one submission, such as is done by the mail com¬ 
mand, or 


2. Permit multiple message submissions, as is done by the SMTP 
channel and the MMDF telephone slave . 

The first mode is specified by passing any initialization information in 
the submit invocation line (i.e., the exec(S) call). In the second mode, 
the initialization information is given as the first input line, tor eacn 
submission. The format of this information is the same for both 
modes. 


Response & Error Handling 

1. Accept input until error or end of message, but terminate on any 
error, or 

2. Notify result for each segment and continue. 
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Response mode #1 is mandatory with Multiple mode #1. Response 
mode #2 is called protocol mode. During it, each address produces a 
status reply and the message text produces a reply. The domain of the 
term segment depends on the error. Simple addressing errors cause 
rejection only of the erroneous address. Other errors may cause rejec¬ 
tion of the entire message, but permit submission of following mes¬ 
sages. 


Addresses 

1. Extracted from components of the message text, 

2. Explicit list given, ahead of message text, or 

3. Both of the above (extracted and explicit addresses) 

The first mode is common when mode #1 (non-protocol) is also in 
force for the Interaction and the Verification option. The second mode 
is commonly in force when the second modes apply for the other 
options (protocol mode). 


Initialization 

A message’s initialization information is specified through a single 
string, passed either in the process-invocation argument list or in the 
first line of submit input. Hence, the string may be terminated either 
by a null or newline. Spaces and tabs in the line are ignored, unless 
part of a literal. Specification is only required for non-defaults. 


Option 

Value 

Literal 

Relay source 
for the “Via” or 
“Received’ ’ field 

a. none 

b. source channel 

c. source host 

(default) 

i...* 

h...* 

From/Sender 

authentication 

a. reject on error 

b. trust 

(< default ) 
t 


c. no trust (disclaim) 

u 

Source-Info Field 

a. not included 

b. disclaim author 

(default) 

u 


c. user text 

f...* 

Address list source 

a. explicit list 

b. extract from 

(default) 

X...* 


components 
c. both (extract and 
explicit) 

g...* 
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5. Address verification 

a. abort on invalid ( default ) 

b. report on each v 



address 


6. Delivery destination 


a. mailbox 

m ( default) 


b. user’s tty 

y 


c. mailbox and tty 

b 

7. Delivery attempt 

a. leave for daemon 

0 default) 

(combinable) 

b. deliver local now 

1 

c. deliver netmail now 

n 

8. Observation of 

a. none 

(default) 

immediate 

b. user will watch 

w 

attempts 

9. Return address 

a. send to submittor 

r 


b. send to “Sender:” 

s 


c. do not return 

q 


d. as specified 

(next line) 

10. Returned mail 

a. entire original 

(default) 

contents 

b. citation only 

c 

11. Warnings 

a. send warnings 

(default) 

b. do not send warnings 

z 

12. Delay channel 

a. enable delay channel 

(default) 

usage 

b. don’t use delay 

d 

13. Delay channel 

a. not delay channel 

(default) 

indicator 

b. delay channel 

j 

14. Nameserver 

a. short timeouts 

(default) 

timeouts 

b. as specified 

k...* 

15. Submission 

a. not shown 

(default) 

tracing 

b. watch submission 

W 

16. Logging file 

a. as per msglog 

(default) 

b. as specified 

L...* 

17. Logging level 

a. as per msglog 

(default) 

b. as specified 

y * 
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General 

Literals shown as characters, followed by an ellipsis, followed by 
an asterisk (e.g. x...*), represent a string. The first character 
specifies the nature of the setting. The value for the setting is 
placed between that character and the asterisk. The value may be 
any string not containing an asterisk, null, or newline. The values 
for settings x and g are comma-separated lists of strings. These 
strings may not contain asterisks, nulls, newlines, or commas. 

Specific 

1. Relaying 

This is used when the calling program is interfacing with another 
distribution system, effecting relaying. The literal after the i 
specifies the channel the message is coming from. The h may be 
used, m conjunction with i, to specify the source host. The literal 
is the name of the host. 

2. Authentication 

Normally, the message must correctly identify its sender. Anyone 
may send “anonymous” (unsigned) mail, but they must use the u 
setting which bypasses authentication. However, it also causes 
MMDF to include, in the Source-Info: component, a statement 
noting the absence of authentication. Only root or relays may use 
the t setting, which bypasses authentication and does not add a dis¬ 
claimer. Others requesting it get u treatment. 

3. Source-Info 

In addition to the action explained above, Source-Info: can 
directly receive text, from the user, through the f setting. The 
value string is replicated on a separate line in the field. 

4. Address lists 

An explicit list has one address per line. When x or g are specified, 
they list the names of message components, such as “To:” and 
“CC:”, which are to be searched for addresses. 

5. Verification 

Normally, any illegal address will cause the entire message to be 
rejected. In v (verify) mode, the acceptability of each message is 
reported and encountering an illegal address does not abort sub¬ 
mission. 

6. Delivery type 

Mail may be delivered to a recipient’s mailbox (file), online termi¬ 
nal (if the recipient is logged in), or a combination of the two. 
There is no default. For each message, its delivery mode must be 
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specified. 

7. Attempt 

An immediate attempt causes a special deliver process to be 
forked and it will attempt to process the indicated mail immedi¬ 
ately. (The n setting does not allow more granularity, for histori¬ 
cal reasons.) Otherwise, the system’s background daemon will get L j| 
to it eventually. The daemon also handles mail that initially could 
not be delivered/relayed. A channel’s descriptor structure (in 
chan.c or the runtime tailor file) specifies a channel as being 
Active, Passive, or Background. Only the first is processed by any 
request for immediate delivery. The second indicates a Post Office 
Box-style channel. The third limits the channel to processing by 
the background deliver daemon, which may be necessary for re¬ 
stricting access to special channels, such as dial-out telephones. 

8. Observation 

If an immediate attempt is requested, the user may elect to watch 
its progress. Deliver and its children will report assorted aspects 
of their activity. If a quiet attempt is requested, submit returns as 
soon as submission is completed. That is, a quiet attempt is per¬ 
formed detached. 


9. Return address 

If the invoker of submit is not to receive return mail (e.g., 
notification of delivery failure) then the next input line (the first, if 
settings are specified in the exec (S) call), contains an address that 
should receive the notification. It is not validated. If either the r 
or the s switch is given, submit will not read a line for the return 
address. If no return mail should be sent, the return address line 
should be empty (i.e., consist of a newline, only.) If the q switch is 
given, a return address is read from the next line of input but the 
local system will not return mail if delivery problems are encoun¬ 
tered. The return address given may be used by other systems (if 
there are mail relays between the local system and the recipient). 

10. Return contents 

Normally, a copy of the entire message is sent with a delivery- 
failure notice. Using the c switch causes a citation, comprising the 
message header and first three lines of non-blank lines of the body, 
to be sent. If more than 12 addresses are specified, for a message, 
citation-only is automatically set. In addition, no warning message 
will be sent for addresses which take a long time to process (a site 
dependent value); the final failure notice will always be sent, if 
there are addresses that are never fully processed. 


11. Warnings 

Normally MMDF will send a non-delivery warning if a message 
has been undelivered after a small period (typically 12 to 72 hours, 
depending on the site). Deliver attempts continue until a timeout 
period is reached. This is typically after 3 to 10 days, depending 
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12. Disable delay channel 

The delay channel is used to process mail submissions that could 
not queued because necessary nameserver information was una¬ 
vailable and therefore an authoritative decision on the validity of 
the address was not possible. If the d option is specified, use of the 
delay channel is prohibited. If the nameserver fails, a error is 
returned, rather than a conditional OK. 

13. Delay channel indicator 

This option is intended only to be used by the delay channel itself 
to indicate to submit that the invoking process IS the delay chan¬ 
nel. This option implies the d option above. 

14. Nameserver timeouts 

By default, MMDF uses a short timeout algorithm. This is suitable 
for user interface programs which don’t want to wait a long time 
for dead nameservers. The k option allows a different timeout to 
be set. The value given is the number of seconds to wait for the 
nameserver lookup to complete. 

15. Submission tracing 

The W option causes submit to print a detailed description of its 
activities on file descriptor 2. It will indicate, for each addressee, 
the channel and addresses queued. This can generate a great deal 
of output if a mailing list is encountered, so it should be used with 
caution. 

16. Logging fde 

The L option allows the specification of an alternate logging file at 
runtime. The string following the L should be the name of the 
logfile to be used. It can be terminated by a * or the end of the 
arguments. This option is only available to the Superuser or 
MMDF. 

17. Logging level 

The V option allows the setting of the logging level at runtime. 
The string following the V should be one of the valid MMDF log¬ 
ging level strings such as FTR or BST. It can be terminated by a * 
or the end of the arguments. This option is only available to the 
Superuser or MMDF. 
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Input Stream 

The following augmented BNF characterizes submit’s input (file 
descriptor zero) format: 


stream: 

*(init-seq V msg-info null) [null] 

init-seq: 

*{ switches listed above } 

msg-info: 

[ret-addr] V’ 

[addr-seq ’!’ ’W] 


{ rfc822-format message } 

ret-addr: 

{ rfc822-format (return) address } 

addr-seq: 

*( rfc822-address } 


Address Format 

Addresses are expected to conform to the ARPANET mail standard 
known as RFC-822, available from the Network Information Center at 
SRI International, submit (and MMDF in general) also continues to 
support RFC-733 style mail for compatibility with earlier mail sys¬ 
tems. 

In addition to those in RFC-822, the following address delimiters are 
recognized within the local part of addresses (in order of precedence): 

@ 

% 

I 


The “!” delimiter is interpreted as “hostluser” while the others are 
interpreted as “user?host”. For example, the address 
“a.b!user%c@localhost” would be queued for “a.b!user@c”. The 
address “a.b!user@localhost’ ’ would be queued for “user@a.b”. The 
address “user.a@localhost” would be queued for “user@a”. Note 
that recognition of the delimiter is a site-selectable option. 

Also, addresses may be indirectly referenced, through a file specifica¬ 
tion of the form: 

‘ ‘<filename’ ’ or “ :include: filename’ ’ 

where the angle-bracket must be the first non-blank character of the 
specification (to distinguish it from the “<...>” usage, above). 

Addresses in the file may be separated by commas or newlines. 
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Example Interactions 

Phases involve Invocation (Invoke), data sent into submit via its file 
descriptor zero (To), data returned from submit via its file descriptor 
one (From), iteration back to the specified phase (Loop), and process 
exit value (Exit). 

1. Simple, single-message, as with the v6mail command: 

a. Invoke: Parameters, “-mlrxto.cc*”, indicate that the 


b. To: 

message is to be sent to recipients’ mailboxes, 
local mail should be sent immediately, return 
mail goes to the submittor, and addresses are to 
be extracted from the “To:” and “cc:“ com¬ 
ponents. 

The entire message 

c. From: 

Error messages 

d. Exit: 

Process return value, in wait(&val), taken from 
mmdf.h, indicating submission status. 


2. Standard, multi-message protocol: 
a. Invoke: No parameters 


b. To: 

Initialization information line. A typical user 
program might have "mlrv", indicating the mes¬ 
sage is to be sent to mailboxes, local mail sent 
immediately, return mail goes to the sender, and 
each address verification is to be reported. A 
relay program might have 

“mlntviVGR.BRL.MIL*,” with “mlv” as 
above and the other settings indicating that mail 
for non-local channels is to be sent immediately, 
die author information is to be trusted, and the 
"Received: " component should cite the mail as 
being relayed via Internet host VGR.BRL.MIL. 

c. To: 

One address, terminated by a newline (Vn’). 

d. From: 

Status character, from mmdf.h, plus human- 
oriented text plus newline. 

e. Loop: 

Back to (c). Terminate with address line having 
only an exclamation mark (!), with newline. 

f. To: 

Message text, in Internet RFC #822 format. 
Multi-line, terminated by null (VO’). 
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g. From: Status character, text, newline. 

h. Loop: Back to (b). Terminate with initialization line 

having only a null, without newline. 

Channels 


When MMDF is used in conjunction with the DARPA domain 
nameserver system, a “delay” channel should be configured to 
allow queuing of addresses that fail verification temporarily due to 
nameserver failures (unavailability). Two other special channels 
that can be configured are the “badusers” and “badhosts chan¬ 
nels. Mail to unknown users or unknown hosts will be queued to 
these channels if they are configured. The bad channels have no 
special code associated with them. The channel configuration 
should reference whatever table and program is necessary to reach 
a smarter host which can deliver or forward the mail. The channel 
should have the “host=” parameter set to this host name. The 
channel names given above are reserved. 

Files 


Numerous. Generally under the MMDF login directory. 


See Also 

send(ADM), mmdf(S), deliver(ADM) 
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sulogin _ 

access single-user mode 

Syntax 

sulogin 

Description 


sulogin is automatically invoked by ink when the system is first 
started. It prompts the user to type the root password to enter system 
maintenance mode (single-user mode) or to type CTRL-D for normal 
startup (multi-user mode), sulogin should never be directly invoked 
by the user. 

Files 


/bin/sulogin 

See Also 


init(M) 

Value Added 


sulogin is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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swap _ 

swap administrative interface 


Syntax 

/etc/swap -a swapdev swaplow swaplen 
/etc/swap -d swapdev swaplow 
/etc/swap -1 


Description____ 

The swap command provides a method of adding, deleting, and moni¬ 
toring the system swap areas used by the memory manager. The fol¬ 
lowing options are recognized: 

-a Add the specified swap area, swapdev is the name of the block 
special device, e.g., /dev/dsk/lsO. swaplow is the offset in 512- 
byte blocks into the device where the swap area should begin. 
swaplen is the length of the swap area in 512-byte blocks. This 
option can only be used by the super-user. Swap areas are nor¬ 
mally added by the system start-up routine /etc/rc when gomg 
into multiuser mode. 

-d Delete the specified swap area, swapdev is the name of a block 
special device, e.g., /dev/dsk/lsO. swaplow is the offset in 512- 
byte blocks into the device where the swap area should begin. 
This option can only be used by the super-user. 

-1 List the status of all the swap areas. The output has four 
columns: 


The swapdev special file for the swap area if one can be 
found in the /dev/dsk or /dev directories, and its major/mmor 
device number in decimal. 


The swaplow value for the area in 512-byte blocks. 


The swaplen value for the area in 512-byte blocks. 

free; „ , . , 

The number of free 512-byte blocks m the area. 
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No check is done to see if a swap area being added overlaps with an 
existmg swap area or file system. 
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sync _ 

updates the super-block 

Syntax 

sync 


Description 


sync executes the sync system primitive. If the system is to be 
stopped, sync must be called to ensure file system integrity. Note that 
shutdown (ADM) automatically calls sync before shutting down the 
system. 


See Also 


sync(S) 

Standards Conformance 

sync is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sysadmsh _ 

menu driven system administration utility 

Syntax 


sysadmsh 

Description 


sysadmsh is an easy-to-use menu interface designed to provide novice 
users with the tools needed for day-to-day system administration of 
the UNIX system. 

WARNING: sysadmsh does not replace the documentation. It pro¬ 
vides an overview of available system administration features and a 
reminder of tasks which need to be performed regularly. An under¬ 
standing of the Installation Guide , the System Administrator's Guide , 
and the User's Guide is necessary to use sysadmsh. 

Usage 


sysadmsh menus can be invoked by logging in as the super-user (root) 
and entering: 

sysadmsh 

at the shell prompt. 

Once you are in sysadmsh , on-line instructions for its use may be 
obtained by selecting the <F1> key. 

Some sysadmsh options must be run from the system console device. 
Some options must be run while in single user (system maintenance) 
mode. Check the documentation manual page referenced by the menu 
selection for more information. 

Environment Variables 


sysadmsh uses the following environment variables: 

• SCOLIB is used to locate the tcap directory which contains vari¬ 
ous terminal-speci fic O/A files. The location procedure is: 

the directory .tcap/ terminal type is searched for in the user’s 
home directory, if this does not exist then, 


March 15, 1989 


SYSADMSH-1 










SYSADMSH (ADM) 


SYSADMSH (ADM) 


the directory $(SCOLIB) /tcap/ terminal type is searched for, 
if this does not exist then, 

the directory .tcap/generic is searched for in the user’s home 
directory, if this does not exist then. 

The directory $(SCOLIB) /generic is searched for. 

If the SCOLIB variable is not explicitly set then it defaults to 
/usr/lib/sco 

• SYSADM is used to find the O/A prompt file libstrs, plus the 
menu, form and help files. 

There are three environment variables which sysadmsh considers to 
locate the editor it calls. SA_EDITOR is tried first, if this is null then 
VISUAL is tried, then EDITOR. 

If none of the editor environment variables are set then, one of the fol¬ 
lowing editors is chosen: /usr/bin/lyrix, /bin/vi or /bin/ed (listed in 
decreasing preference). 

The following additional environment variables are used: 

SA_MAIL If not set, the default mailer is SCO Portfolio email if 
installed, or regular UNIX mail(C) if not. 

SAJPRINT If not set, the default printer device is /dev/lp. 

See Also 


System Administrator’s Guide 
User’s Guide 
Installation Guide 

acctcom(ADM), accton(ADM), asktime(ADM), at(C), badtrk(ADM), 
checklist(F), chgrp(C), chmod(S), chown(C), configure(ADM) 
copy(C), cron(C), csh(C), custom(ADM), df(C), difl(C), dircmp(C), 
disable(C), diskcmp(C), diskcp(C), dmesg(ADM), dos(C), dtype(C), 
du(C), enable(C), fdisk(ADM), find(C), finger(C), fixperm(ADM), 
format(C), fsck(ADM), grpcheck(C), init(M), kill(C), login(M), lp(C), 
lpadmin(ADM), lpstat(C), mail(C), mkdev(ADM), more(C), 
mount(ADM), netutil(ADM), ps(C), quot(C), shutdown(ADM), 
systemid(F), tar(C), umount(ADM), uuinstall(ADM), vi(C), 
wall(ADM), who(C), write(C) 

Notes 

A knowledge of vi'(C) is assumed for file edit selections, although the 
SCO Lyrix® editor is used when available. 
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sysdef _ 

output values of tunable parameters 

Syntax 

/etc/sysdef [ system_namelist [ conf ] ] 


Description 


The sysdef command outputs the values of all tunable parameters. It 
generates the output by analyzing the named operating system file 
(.systemjiamelist ) and extracting the configuration information trom 
the name list itself. 


Files 


/unix 

/etc/conf/* 

See Also 


default operating system file (where the system 
namelist is) 

default directory containing master files 


nlist(S) 

Diagnostics 


internal name list overflow 

If the master table contams more than an inter¬ 
nally specified number of entries for use by 
nlist( S). 


Standards Conformance 


sysdef is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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tcbck, smmck, authckrc 



trusted computing base checker 

Syntax 


tcbck 


Description 




tcbck checks the files in the trusted computing base for files that were 
caught in the process of being updated when the system went down, 
and for files that have been removed, tcbck is invoked by the scripts 
/etc/smmck during system maintenance mode, and by /etc/authckrc 
when the system enters multi-user mode. The check proceeds as fol¬ 
lows: 

1. /etc!smmck runs tcbck to clean up any database files that were 
left in an interim state while being updated (files are created 
with -o (old) and -t (new) suffixes, respectively). When this 
process is interrupted, -o and -t files are left and must be recon¬ 
ciled before the system will function properly, tcbck 
checks the /etc/auth/system, /etc/auth/subsystems and 
/tcb/files/auth/* directories. If there are multiple versions of a 
file, the extra files are removed. When a -t file is found, the 
following is displayed: 

/etc/tcbck: fil efile missing, saved file-t as file 

This message is repeated for all files found in that state in the 
specified directories. 

2. Next tcbck removes / etc/ au th/system/p widmap and 
/etc/auth/system/gr_id_map because the modification times of 
these files are compared with those of /etc/passwd and 
/etc/group and problems can occur when the system clock is 
reset. 

3. tcbck checks that key system files are present and that they are 
not of zero length. If a file is missing (or zero length) then a 
message similar to this is displayed: 

/etc/tcbck: file file is missing or zero length 
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This process is repeated for each of the following files: 

/etc/aut h/sy stem/default t 

/etc/auth/system/files 

/etc/auth/system/devassign 

/etc/auth/system/ttys 

/etc/auth/system/authorizet 

/tcb/files/auth/r/rootf 

/etc/group 

/etc/passwdf 

When this process is complete, if any files were missing or -t files 
were substituted for real files, the following message is displayed: 

/etc/smmck: restore missing files from backup or distribution. 

4. If critical database files have been removed or corrupted (files 
marked with a dagger (f) in the previous file list are considered criti¬ 
cal) then the system enters maintenance mode automatically without 
asking for the root password. If no critical database files were lost, 
the system prompts for maintenance mode or normal operation. 

5. After the system goes to init level 2, letc/authckrc reinvokes tcbck to 
confirm that the files reported missing previously have been restored: 
Any missing files are listed, followed by this message: 

/etc/authckrc: Log in on the OVERRIDE tty and restore 

the missing files from a backup or the distribution disks. 

Missing files will have to be replaced when the system comes up 
multi-user. 

6. Finally authckrc prompts for checking the protected subsystem 
databases. If the response is yes, the authck(ADM) program is run. 

Value Added 


tcbck is an extension of AT&T System V provided by The Santa Cruz 
Operation, Inc. 
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timex ___ 

time a command; report process data and system 

activity 

Syntax 

timex [ options ] command 

Description 


The given command is executed; the elapsed time, user time and sys¬ 
tem time spent in execution are reported in seconds. Optionally, pro¬ 
cess accounting data for the command and all its children can be listed 
or summarized, and total system activity during the execution interval 
can be reported. 

The output of timex is written on standard error. 

Options are: 

-p List process accounting records for command and all its children. 
This option works only if the process accounting software is 
installed. Suboptions f, h, k, m, r, and t modify the data items 
reported. The options are as follows: 

-f Print the fork/exec flag and system exit status columns in the 
output. 

-h Instead of mean memory size, show the fraction of total avail¬ 
able CPU time consumed by the process during its execution. 
This “hog factor” is computed as: 

(total CPU time)/(elapsed time). 

-k Instead of memory size, show total kcore-minutes. 

-m Show mean core size (the default). 

-r Show CPU factor (user time/(system-time + user-time). 

-t Show separate system and user CPU times. The number of 
blocks read or written and the number of characters transferred 
are always reported. 

-o Report the total number of blocks read or written and total char¬ 
acters transferred by command and all its children. This option 
works only if the process accounting software is installed. 
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-s Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All the data 
items listed in sar{ C) are reported. 


See Also 


sar(ADM). 


Warning 


Process records associated with command are selected from the 
accounting file /usr/adm/pacct by inference, since process genealogy 
is not available. Background processes having the same user-id, 
terminal-id, and execution time window will be spuriously included. 

Examples 


A simple example: 


timex -ops sleep 60 


A terminal session of arbitrary complexity can be measured by timing 
a sub-shell: 

timex -opskmt sh 


session commands 

EOT 


Standards Conformance 



timex is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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tplot 

graphics filters 


Syntax 


tplot [ -Tterminal [ -e raster ] ] 


Description 


Tliis command reads plotting instructions [see plot(F)] from the stan¬ 
dard input and m general produces, on the standard output clotting 
fied rU th tl e°e S n SUltable fOT ® particular terminal. If no terminal’£ spec? 

faiSZ? parameIer $TERM [see “< M >i * ^ 

300 

DASI300. 

300S 

DASI 300s. 

450 

DASI 450. 

4014 

Tektronix 4014. 
ver 

VE R SATE CD12 0°A. This version of plot places a scan- 
converted image in /usr/tmp/raster$$ and sends the result directly 
to the plotter device, rather than to the standard output The -e 
option causes a previously scan-converted file raster to be sent to 


Files 


/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

Aisr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/raster$$ 


See Also 


plot(S), plot(F), term(M) 
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uadmin _ 

administrative control 


Syntax 

/etc/uadmin command function 


Description 


The uadmin command provides control for basic administrative func- 
Sns ^command is tightly coupled to the System AdmnustraUon 
procedures and is not intended for general use. It may be mvoked only 
by the super-user. 


The arguments command and function are converted to integers and 
passed to the uadmin system call. 


See Also 


uadmin(S) 
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umount _ 

dismounts a file structure 

Syntax 

/etc/umount special-device 

Description 


umount announces to the system that the removable file structure pre¬ 
viously mounted on device special-device is to be removed. Any 
pending I/O for the file system is completed, and the file structure is 
flagged clean. For a detailed explanation of the mounting process, see 
mount( ADM). 

Files 


/etc/mnttab Mount table 

See Also 


mount(ADM), mount(S), mnttab(F) 

Diagnostics 


device busy An executing process is using a file on the named 
file system. 

Standards Conformance 


umount is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uucheck _ 

checks the uucp directories and permissions file 

Syntax 

/usr/Iib/uucp/uucheck [ -v ] [ -x debug_level ] 

Description 


uucheck checks for the presence of the uucp system required files and 
directories. It also checks for some obvious errors in the Permissions 
file (/usr/lib/uucp/Permissions). When executed with the -v option, 
it gives a detailed explanation of how the uucp programs will interpret 
the Permissions file. The -x option is used for debugging, debug- 
option is a single digit in the range 1-9; the higher the value, the 
greater the detail. 

Note that uucheck can only be used by the super-user or uucp. 

Files 


Aisr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

See Also 


uucico(ADM), uusched(ADM), uucp(C), uustat(C), uux(C) 

Notes 


The program does not check file/directory modes or some errors in the 
Permissions file such as duplicate login or machine name. 
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UUCICO _ 

file transport program for the UUCP system 

Syntax 


/usr/lib/uucp/uucico [ -r role_number ] [ -x debug_level ] 

[ -i interface ] [ -d spool_directory ] [ -s ] [ -S ] system_name 

Description 


uucico is the file transport program for uucp work file transfers. Role 
numbers for the -r are the digit 1 for master mode or 0 for slave mode 
(default). The -r option should be specified as the digit 1 for master 
mode when uucico is started by a program or cron, uux and uucp both 
queue jobs that will be transferred by uucico. It is normally started by 
the scheduler, uusched , but can be started manually; this is done for 
debugging. For example, the shell uutry starts uucico with debugging 
turned on. A single digit must be used for the -x option with higher 
numbers for more debugging. 

The -i option defines the interface used with uucico. This interface 
only affects slave mode. Known interfaces are UNIX (default), TLI 
(basic Transport Layer Interface), and TLIS (Transport Layer Interface 
with Streams modules, read/write); only the default, UNIX, is applica¬ 
ble in this release. 

The -d option can be used to specify the spool directory: the default is 
/ usr!spoolluucp. 

If -s is specified, a call to the specified site is made even if there is no 
work for site sitename in the spool directory, but call only when times 
in the Systems file permit it. This is useful for polling sites that do 
not have the hardware to initiate a connection. 

The -S option can be used to specify the system name, overriding the 
call schedule given in the Systems file. For example, -S can be used 
to call a system which is said to be “Never” called in the Systems file. 
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Files 


UUCICO (ADM) 


/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

See Also 


uusched(ADM), uutry(ADM), cron(C), uucp(C), uustat(C), uux(C) 
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uuclean 


UUCP spool directory clean-up 

Syntax 


/usr/lib/uucp/uuclean [ -Ctime ] [ -Dtime ] [ -Wtime ] [ -Xtime ] 
[ -instring ] [ -otime ] [ -ssystem ] [ -xdebugjevel ] 

Description 


uuclean will scan the spool directories for old files and take appropri¬ 
ate action to remove them in a useful way: 

Inform the requestor of send/receive requests for systems that can not 
be reached. 

Return mail, which cannot be delivered, to the sender. 

Delete or execute mews for mews type files (depending on where the 
news originated—locally or remotely). 

Remove all other files. 

In addition, there is provision to warn users of requests that have been 
waiting for a given number of days (default 1). Note that uuclean will 
process as if all option times were specified to the default values 
unless time is specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days old will be 

removed with appropriate information to the requestor, 
(default 7 days) 

-Dtime Any D. files greater or equal to time days old will be 
removed. An attempt will be made to deliver mail mes¬ 
sages and execute mews when appropriate, (default 7 
days) 

-W time Any C. files equal to time days old will cause a mail mes¬ 

sage to be sent to the requestor warning about the delay in 
contacting the remote. The message includes the JOBID , 
and in the case of mail, the mail message. The adminis¬ 
trator may include a message line telling whom to call to 
check the problem (-m option), (default 1 day) 
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UUCLEAN (ADM) 


-Xtime 

Any X. files greater or equal to time days old will be 
removed. The D. files are probably not present (if they 
were, the X. could get executed). But if there are D. files, 
they will be taken care of by D. processing, (default 2 
days) 

-m string 

This line will be included in the warning message gen¬ 
erated by the -W option. 

-o time 

Other files whose age is more than time days will be 
deleted, (default 2 days) The default line is "See your 
local administrator to locate the problem". 


-s system Execute for system spool directory only. 

-xdebugjevel 

The -x debug level is a single digit between 0 and 9; higher num¬ 
bers give more detailed debugging information. 

This program is typically started by the shell uudemon.clean, which 
should be started by cron{ C). uuclean can only be executed by the 
super user or uucp. 

Files 


Aisr/lib/uucp directory with commands used by uuclean 

internally 

/usr/spool/uucp spool directory 

See Also 


cron(C), uucp(C), uux(C) 
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uudemon: uudemon.admin, 
uudemon.clean, uudemon.hour, 
uudemon.poll, uudemon.poll2 

UUCP administrative scripts 

Description 

UUCP communications and file maintenance can be automated with 
the use of the uudemon.hour, uudemon.poll, uudemon.poll2, 
uudemon.admin, and uudemon.clean shell scripts. While in multi¬ 
user mode, cron scans files in /usr/spool/cron/crontabs once each 
minute for entries to execute at this time. An example crontabs file, 
crontab.eg , is provided to activate these daemons. The system 
administrator should copy these from /usr/lib/uucp to 
/usr/spool/cron/crontabs/uucp. To do this, log in as user uucp, edit 
the crontab.eg file to make any changes, and then enter the following 
command: 

crontab crontab.eg 

This will replace the original crontab entry. 


uudemon.admin 

The uudemon.admin shell script, as delivered, runs the uustat com¬ 
mand with -p and -q options. The -q reports on the status of work files 
(C.), data files (D.), and execute files (X.) that are queued. The -p 
prints process information for networking processes listed in the lock 
files (/usr/spool/locks). It sends resulting status information to the 
UUCP administrative login (uucp) via mail. 

The default crontab entry for uudemon.admin is: 

48 10,14 * * 1 - 5 /bin/su uucp -c \ 

"/usr/lib/uucp/uudemon.admin" > /dev/null 

uudemon.clean 

The uudemon.clean shell script, as delivered, takes log files for indi¬ 
vidual machines from the /usr/spool/.Log directory, merges them, and 
places them in the Aisr/spool/.Old directory with other old log infor¬ 
mation. If log files get large, the ulimit may need to be increased. It 
also removes work files (C.) 7 days old or older, data files (D.) 7 days 
old or older, and execute files (X.) 2 days old or older from the spool 
files, uudemon.clean mails a summary of the status information 
gathered during the current day to the UUCP administrative login 
(uucp). 
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The default crontab entry for uudemon.clean is: 


45 23 * * * ulimit 5000; /bin/su uucp -c \ 

"/usr/lib/uucp/uudemon.clean" > /dev/null 

uudemon.hour 

The uudemon.hour shell script calls the uusched program to search 
the spool directories for work files (C.) that have not been processed 
and schedules these files for transfer to a remote machine. It then 
calls the uuxqt daemon to search the spool directories for execute 
files (X.) that have been transferred to your computer and were not 
processed at the time they were transferred. 

This is the default root crontab entry for uudemon.hour : 

39, 9 * * * * /usr/lib/uucp/uudemon.hour > /dev/null 

This script runs twice per hour (at 39 and 9 minutes past). 


uudemon.poll 

uudemon.poll uses the Poll (or the alternative Poll.hour and 
PolLday) file (see poll( F)) for polling remote computers. The 
uudemon.poll script controls polling but does not actually perform 
the poll. It merely sets up a polling file (C.sysnxxxx) in the 
/usi/spoo\/uucp/nodename directory, where nodename is replaced by 
the name of the machine. This file will in turn be acted upon by the 
scheduler (started by uudemon.hour). The uudemon.poll script is 
scheduled to run twice an hour just before uudemon.hour so that the 
work files will be there when uudemon.hour is called. The default 
root crontab entry for uudemon.poll is as follows: 

1,30 * * * * "/usr/lib/uucp/uudemon.poll > /dev/null" 

uudemon.poll2 is an alternative to uudemon.poll, which uses a dif¬ 
ferent scheme and different poll files. Listing a site in the Poll file 
gives you control over the lower bound on number-of-calls-per-day (at 
least as many as you specify in Poll), but still no control on the upper 
bound. (This is because uudemon.poll uses the the time field of the 
Systems file, which is not suited to the purposes of polling). 
uudemon.po!12 permits much more precise control of scheduling. To 
use uudemon.poll2, you must remove the call to uusched from 
uudemon.hour, and run uudemon.poll2 in place of uudemon.poll 
from cron. uudemon.poll2 reads Poll.hour (or Poll.day if called with 
the -d option) to determine whom to poll much like uudemon.poll, 
but calls uucico directly, using the -S option, thus overriding the time 
field of the Systems file. 
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Files 


UUDEMON (ADM) 


/usr/lib/uucp/Systems 

/usr/lib/uucp/uudemon.admin 

/usr/lib/uucp/uudemon.clean 

/usr/lib/uucp/uudemon.hour 

/usr/lib/uucp/uudemon.poll 

/usr/lib/uucp/uudemon.poll2 

Aisr/lib/uucp/Poll 

Aisr/lib/uucp/Poll.hour 

/usr/lib/uucp/Poll.day 

See Also 


uusched(ADM) uucico(ADM), uuclean(ADM), cron(C), uucp(C), 
poll(F) systems(F) 

Standards Conformance 


uudemon is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 

uudemon.pol!2 is an extension of AT&T System V provided by The 
Santa Cruz Operation, Inc. 
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uugetty _ 

set terminal type, modes, speed, and line discipline 

^ Syntax 


/usr/lib/uucp/uugetty [-t timeout] [-r] line [speed [type [linedisc] ] ] 

/usr/Iib/uucp/uugetty -c file 

Description 


uugetty is a standard getty (M) modified to allow a tty line to be used 
by uucico, cu, and ct', that is, the line can be used in both directions. 
The uugetty will allow users to login, but if the line is free, uucico, cu, 
or ct can use it for dialing out. The implementation depends on the 
fact that uucico, cu, and ct create lock files when devices are used. 
When the open() returns (or the first character is read when -r option 
is used), the status of the lock file indicates whether the line is being 
used by uucico, cu, ct, or someone trying to login. Note that in the -r 
case, several <carriage-retum> characters may be required before the 
logm message is output. The human users will be able to handle this 
slight inconvenience, uucico trying to login will have to be told by 
using the following login script: 


\r\d\r\d\r\d\r in:--in: 


where the ... is whatever would normally be used for the login 
sequence. 


If there is a uugetty on one end of a direct line, there must be a uugetty 
on the other end as well. Here is an /tcb/flles/inittab entry using 
uugetty on an intelligent modem or direct line: 


30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 ttyOO 1200 

The meanings of the available options are: 

-t timeout 

Specifies that uugetty should exit if the open on the line succeeds 
and there is no response to the login prompt in timeout seconds. 
timeout is replaced by an integer. 



-r 


Causes uugetty to wait to read a character before it puts out the 
login message, thus preventing two uugettys from looping. An 
entry for an intelligent modem or direct line that has a uugetty on 
each end must use this option. 
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line 


Defines the name of the line to which uugetty will attach itself. 
The line name will point to an entry in the /dev directory. For 
example, /dev/ttyOO. 


speed 


Defines the entry to use from the /etc/gettydefs file. The entry 
defines the line speed, the login message, the initial tty setting, and 
the next speed to try if the user says the speed is inappropriate (by 
sending a break character). The default speed is 300. 

type 

Defines the type of terminal connected to the line. The default ter¬ 
minal is none, representing a normal terminal unknown to the sys¬ 
tem. 

linedisc 

Sets the line discipline to use on the line. The default is LDISCO, 
which is the only one currently compiled into the operating sys¬ 
tem. 


-c file 


Checks the speed and tty definitions in file and sends the results to 
standard output. Unrecognized modes and improperly constructed 
entries are reported. For correct entries, flag values are printed. 
file is replaced by /etc/gettydefs or a similarly structured file. 


Files 


/etc/gettydefs 

/etc/issue 

See Also 


login(C), ct(C), cu(C), getty(M), init(M), uucico(ADM), tty(HW), 
ioctl(S), gettydefs(F), inittab(F) 

Notes 


ct will not work when uugetty is used with an intelligent modem such 
as penril or ventel. 
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uuinstall _ 

administers UUCP control files 

Syntax 

/etc/uuinstall [-r] 

Description 


The uuinstall program is used to manage the content of the control 
files used by the uucp communications system. It allows the user to 
change the contents of these files without using a text editor. The user 
need not know the detailed format of each of the control files, 
although he must be familiar with the function of the various fields 
within the files. These details are explained in the System 
Administrator s Guide . 

The uuinstall program can only be executed by the super-user. When 
invoked with the optional -r flag, uuinstall will not allow any of the 
files to be modified whether or not the user has made changes to the 
files. 

If uuinstall finds any of the required uucp control files missing from 
the system, it will create them with the correct access permissions and 
ownership. 

Files 


/etc/systemid 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

See Also 


mkuser(ADM) 
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uulist _ 

converts a UUCP routing file to MMDF format 

Syntax 


/usr/mmdf/table/tools/ uulist 

Description 


uulist is a conversion utility to produce MMDF-compatible UUCP rout¬ 
ing files from the UUCP routing file. 

After installing MMDF with custom , restore /usr/lib/uucp/Systems 
from backup media. Log in as root and run the conversion script 
/usr/mmdf/table/tools/ uulist from the /usr/mmdf/table directory. You 
now have UUCP domain and channel files, uucp.dom and uucp.chn, 
in the current directory. Use the chown command to make these files 
owned by mmdf. Log out from the super user account. 

After creating these files in /usr/mmdf/table, you must rebuild the 
MMDF hashed database. Log in as mmdf and run dbmbuild from 

/usr/mmdf/table. 

Files 


/usr/lib/uucp/Systems 

/usr/mmdf/table/uucp.chn 

/usr/mmdf/table/uucp.dom 

See Also 


dbmbuild(ADM), tables(F), “Setting Up Electronic Mail” in the Sys¬ 
tem Administrator’s Guide 

Value Added 


uulist is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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uusched __ 

the scheduler for the UUCP file transport program 

^ Syntax 

/usr/lib/uucp/uusched [ -x debugjevel ] [ -u debugjevel ] 

Description 


uusched is the uucp file transport scheduler. It is usually started by 
the daemon uudemon.hour that is started by cron(C) from an entry in 
/ usrlspool!cron/crontabslroot: 

39,9 * * * * /bin/su uucp -c "/usr/lib/uucp/uudemon.hour" > /dev/null 

The two options are for debugging purposes only; -x debugjevel will 
output debugging messages from uusched and -u debug jevel will be 
passed as -x debugjevel to uucico. The debugjevel is a number 
between 0 and 9; higher numbers give more detailed information. 


Files 


/usr/lib/uucp/Systems 

Aisr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 


See Also 


uucico(ADM), cron(C), uucp(C), uustat(C), uux(C) 
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uutry _ 

tries to contact remote system with debugging on 

Syntax 

/usr/lib/uucp/uutry [ -x debugJevel ] [ -r ] system_name 

Description 

The uutry program is a shell that invokes uucico to call a remote site. 
Debugging is automatically enabled at default level 5; -x overrides 
this value. If uutry successfully connects to the remote system, uutry 
stores the debugging output in the file Itmplsystem, where system is 
the name of the remote system. In addition, uutry uses tail -f to print 
the last 10 lines of the debugging output to the standard output. 

To break out of the shell created by uutry , press DELETE or BREAK . 
This returns control to the terminal while uucico continues to run, 
sending the output to Itmplsystemjiame. 

The -r option overrides the retry time in /usr/spool/uucp/.status. 

Files 


/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/uucppublic/* 

/tmp/system_name 

See Also 


uucico(ADM), uucp(C), uux(C) 
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uuxqt _ 

executes remote command requests 

Syntax 


/usr/lib/uucp/uuxqt [ -s system ] [ -x debug_level ] 

Description 


uuxqt is the program that executes remote job requests from remote 
systems generated by the use of the uux command. (Mail uses uux for 
remote mail requests), uuxqt searches the spool directories looking 
for X. files. For each X. file, uuxqt checks to see if all the required 
data files are available and accessible, and file commands are permit¬ 
ted for the requesting system. The Permissions file is used to validate 
file accessibility and command execution permission. 

There are two environment variables that are set before the uuxqt 
command is executed: 

UU_MACHINE is the machine that sent the job (the previous one). 
UU_USER is the user that sent the job. 

These can be used in writing commands that remote systems can exe¬ 
cute to provide information, auditing, or restrictions. 

The -x debug lev el is a single digit between 0 and 9. Higher numbers 
give more detailed debugging information. 

Files 


/usr/lib/uucp/Permissions 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

See Also 


uucico(ADM), uucp(C), uustat(C), uux(C), mail(C) 
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vectorsinuse _ 

displays the list of vectors currently specified in the 
sdevice file 

Syntax 


/etc/conf/cf.d/vectorsinuse 

Description 


This script searches the sdevice file and displays a list of the interrupt 
vectors already in use. 

You must move to the /etc/conf/cf.d to execute vectorsinuse. 

When installing a device driver with the Link Kit, you can use 
vectorsinuse to find an available interrupt vector for the driver. When 
you invoke the configure program to modify the system configuration 
files with the new driver information, use the -v option to indicate the 
vectors on which this device interrupts. 

The -V option to configure performs a function similar to that of 
vectorsinuse. You specify a particular vector on which the device is 
capable of interrupting (refer to the device’s hardware manual), and 
configure tells you if another device is already using that interrupt 
vector. 

Files 


/etc/conf/cf.d/sdevice 

See Also 


configure(ADM), sdevice(F), “Adding Device Drivers with the Link 
Kit’ ’ in the System Administrator’s Guide 

Value Added 


vectorsinuse is an extension to AT&T System V developed by the 
Santa Cmz Operation. 
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volcopy _ 

make literal copy of UNIX filesystem 

Syntax 


/etc/volcopy [options] fsname srcdevice volnamel destdevice vol- 
name2 


Description 


The volcopy command makes a literal copy of the UNIX filesystem 
using a blocksize matched to the device. Options are: 

-a invoke a verification sequence requiring a positive operator 
response instead of the standard 10-second delay before the 
copy is made 

-s (default) invoke the DEL if wrong verification sequence. 

The program requests length and density information if it is not given 
on the command line or is not recorded on an input tape label. If the 
filesystem is too large to fit on one reel, volcopy will prompt for addi¬ 
tional reels. Labels of all reels are checked. Tapes may be mounted 
alternately on two or more drives. If volcopy is interrupted, it will ask 
if the user wants to quit or wants a shell. In the latter case, the user 
can perform other operations (e.g., labelit) and return to volcopy by 
exiting the new shell. 

The fsname argument represents the mounted name (e.g., root, ul, 
etc.) of the filsystem being copied. 

The srcdevice or destdevice should be the physical disk section or tape 
(e.g.: /dev/dsk/Osl etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and 
should match the external label sticker. Such label names are limited 
to six or fewer characters, volname may be - to use the existing 
volume name. 

srcdevice and volnamel are the device and volume from which the 
copy of the filesystem is being extracted, destdevice and volnamel 
are the target device and volume. 

fsname and volname are recorded in the last 12 characters of the super 
block (char fsname[6], volname[6];). 
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Files 

/etc/log/filesave.log a record of filesystems/volumes copied 

See Also 


labelit(ADM), sh(C), filesystem(F) 

Standards Conformance 


volcopy is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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wall _ 

writes to all users 

Syntax 

/etc/wall 

Description 


wall reads a message from the standard input until an end-of-file. It 
then sends this message to all users currently logged in preceded by 
“Broadcast Message from wall is used to warn all users, for 
example, prior to shutting down the system. 

The sender should be super-user to override any protections the users 
may have invoked. 

Files 


/dev/tty* 

See Also 

mesg(C), write(C) 

Diagnostics 

Cannot send to ... The open on a user’s tty file has failed. 
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wtinit _ 

object downloader for the 5620 DMD terminal 

Syntax 


/usr/lib/layersys/wtinit [-d] [-p] file 

Description 


The wtinit utility downloads the named file for execution in the AT&T 
TELETYPE 5620 DMD terminal connected to its standard output, file 
must be a DMD object file, wtinit performs all necessary bootstrap 
and protocol procedures. 

There are two options: 

-d Prints out the sizes of the text, data, and bss portions of the down¬ 
loaded file on standard error. 

-p Prints the downloading protocol statistics and a trace on standard 
error. 

The environment variable JPATH is the analog of the shell’s PATH 
variable to define a set of directories in which to search for file. 

If the environment variable DMDLOAD has the value hex, wtinit will 
use a hexadecimal download protocol that uses only printable charac¬ 
ters. 

Terminal Feature Packages for specific versions of AT&T windowing 
terminals will include terminal-specific versions of wtinit under those 
installation sub-directories, /usr/lib/layersys/wtinit is used for 
layers{C) initialization only when no Terminal Feature Package is in 
use. 

Diagnostics 


Returns 0 upon successful completion, I otherwise. 
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Notes 


WTINIT (ADM) 


Standard error should be redirected when using the -d or -p options. 

See Also 


layers(C) 


March 15, 1989 


WTINIT-2 










XBACKUP (ADM) 


XBACKUP(ADM) 


xbackup __ 

performs XENIX incremental filesystem backup 

Syntax 

xbackup [ key [ arguments ] filesystem ] 

Description 


xbackup copies all files changed after a certain date in the date in the 
filesystem. xbackup is used for XENIX filesystems; use backup^ ADM) 
for UNIX filesystems. The key specifies the date and other options 
about the xbackup, where a key consists of characters from the set 
0123456789kfusd. The meanings of these characters are described 
below: 

f Places the xbackup on the next argument file instead of the 
default device. 

u If the xbackup completes successfully, writes the date of the 
beginning of the xbackup to the file /etc/ddate. This file records 
a separate date for each file system and each xbackup level. 

0-9 This number is the “xbackup level”. Backs up all files 
modified since the last date stored in the file /etc/ddate for the 
same file system at lesser levels. If no date is determined by the 
level, the beginning of time is assumed; thus the option 0 causes 
the entire file system to be backed up. 

s For xbackups to magnetic tape, the size of the tape is specified 
in feet. The number of feet is taken from the next argument. 
When the specified size is reached, xbackup will wait for reels 
to be changed. The default size is 2,300 feet. 

d For xbackups to magnetic tape, the density of the tape, 
expressed in BPI, is taken from the next argument. This is used 
in calculating the amount of tape used per write. The default is 
1600. 

k This option is used when backing up to a block-structured dev¬ 
ice, such as a floppy disk. The size (in K-bytes) of the volume 
being written is taken from the next argument. If the k argument 
is specified, any s and d arguments are ignored. The default is 
to use s and d. 
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If no arguments are given, the key is assumed to be 9u and a default 
file system is backed up to the default device. 

The first xbackup should be a full level-0 xbackup: 

xbackup Ou 

Next, periodic level 9 xbackups should be made on an exponential 
progression of tapes or floppies: 

xbackup 9u 

This progression is shown as follows: 

1 2 1 3 1 2 1 4 ... 

where xbackup 1 is used every other time, xbackup 2 every fourth, 
xbackup 3 every eighth, etc.) When the level-9 incremental xbackup 
becomes unmanageable because a tape is full or too many floppies are 
required, a level-1 xbackup should be made: 

xbackup lu 

After this, the exponential series should progress as if uninterrupted. 
These level-9 xbackups are based on the level-1 xbackup, which is 
based on the level-0 full xbackup. This progression of levels of 
xbackups can be carried as far as desired. 

The default file system and the xbackup device depend on the settings 
of the variables DISK and TAPE, respectively, in the file 

/etc/default/backup. 

Files 


/etc/ddate Records xbackup dates of file system/level 

/etc/default/backup Default xbackup information 

See Also 


cpio(C), default(F), xdumpdir(ADM), xrestore(ADM), restore(ADM), 
sddate(C), backup(ADM), xbackup(F), System Administrator's Guide 
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Diagnostics 


XBACKUP (ADM) 


If the xbackup requires more than one volume (where a volume is 
likely to be a floppy disk or tape), you will be asked to change 
volumes. Press RETURN after changing volumes. 

Notes 


Sizes are based on 1600 BPI for blocked tape; the raw magnetic tape 
device has to be used to approach these densities. Write errors to the 
xbackup device are usually fatal. Read errors on the file system are 
ignored. 

If the default archive medium specified in I etc I default! xbackup or 
/etc!default!restor is block structured, (i.e. floppy disk) then the 
volume size in Kbytes must be specified on the command line. Nei¬ 
ther utility works correctly without this information. For example, 
using the default device (below) with the xbackup command, enter 
the following: 

xbackup k 360 

The default device entry for / etc!default!xbackup (tape=/dev/xxx) and 
/ etc!default! restor (archive=/dev/xxx) is !dev/rfd02. 

It is not possible to successfully restore an entire active root file sys¬ 
tem. 

Warning 


When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a xbackup. You must also be sure to 
close the floppy door when inserting floppy disks. If you fail to do so 
in a multi-floppy xbackup, the entire xbackup will fail and you will 
have to begin again. 

You should never xbackup more than one filesystem to the tape dev¬ 
ices /dev/nrctO and !dev/nrct2. This is because, although xbackup can 
write more than one filesystem to /dev/nrctO or !dev/nrct2 , restore may 
not be able to restore more than one filesystem from these devices. 

Value Added 


xbackup is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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XDUMPDIR (ADM) 


xdumpdir _ 

prints the names of files on a XENIX backup archive 

Syntax 

xdumpdir [ f filename ] 

Description 


xdumpdir is used to list the names and inode numbers of all files and 
directories on an archive written with the xbackup command. This is 
most useful when attempting to determine the location of a particular 
file in a set of backup archives. 

The f option causes filename to be used as the name of the backup de¬ 
vice instead of the default. The backup device depends on the setting 
of the variable TAPE in the file /etc/default/xdumpdir. The device 
specified as TAPE can be any type of backup device supported by the 
system (for example, a floppy drive or cartridge tape drive). 

Files 


rst* Temporary files 

See Also 

xbackup(ADM), xrestore(ADM), default(F) 

Value Added 


xdumpdir is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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XINSTALL (ADM) 


xinstall _ 

XENIX installation shell script 

Syntax 

/etc/xinstall [ device ] 

Description 

I etc! xinstall is the sh(C) script used to install XENIX distribution (or 
application program) floppies. It performs the following tasks: 

- Prompts for insertion of floppies. 

- Extracts files using the tar{ C) utility. 

- Executes /once/init.* programs on each floppy 
after they have been extracted. 

- Removes any /once/init.* programs when the 
installation is finished. 

The optional argument to the command specifies the device used. The 
default device is /dev/xinstall and is normally linked to 

/dev/rdsk/f0ql5dt. 

Files 

/etc/xinstall 

/once/init.* 

See Also 

custom(ADM), fixperm(ADM), installpkg(ADM) 

Notes 

xinstall is provided for use with any existing XENIX packages you 
may have that you wish to install on a UNIX system, xinstall does not 
work with UNIX system applications [use installpkg{ ADM) to install 
UNIX system applications]. 
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XINSTALL (ADM) 

Value Added 


XINSTALL (ADM) 


xinstall is an extension of AT&T System V provided by the Santa 
Cruz Operation. 
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XRESTORE (ADM) 


xrestore, xrestor _ 

invokes XENIX incremental filesystem restorer 

Syntax 


xrestore key [ arguments ] 
xrestor key [ arguments ] 

Description 


xrestore is used to read archive media backed up with the 
xbackup(ADM) command. 

The key specifies what is to be done. Key is one of the characters cC, 
rR, tT, or xX optionally combined with k and/or f or F. restor is an 
alternate spelling for the same command. 

c,C 

Verify (check) a dump tape. Used after a dump is made to make 
sure the tape has no I/O errors or bad checksums. C is the same as 
c except that it provides a higher level of checking. 

f Uses the first argument as the name of the archive (backup device 
/dev/*) instead of the default. 

F F is the number of the first file on the tape to read. All files up to 
that point are skipped. 

k Follow this option with the size of the backup volume. This allows 
for reading multivolume dumps from media such as floppies. 

r,R 

The archive is read and loaded into the file system specified in 
argument. This should not be done lightly (see below). If the key 
is R, xrestore asks which archive of a multivolume set to start on. 
This allows xrestore to be interrupted and then restarted (an fsck 
must be done before the restart). 

t Prints the date the archive was written and the date the file system 
was backed up. 

T Prints a full listing of a dump tape. Similar to t. 

x Each file on the archive named by an argument is extracted. The 
filename has all “mount” prefixes removed; for example, if /usr is 
a mounted file system, /usr/bin/lpr is named /bin/lpr on the 
archive. 
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XRESTORE (ADM) 


The extracted file is placed in a file with a numeric name supplied 
by xrestore (actually the inode number). In order to keep the 
amount of archive read to a minimum, the following procedure is 
recommended: 

1. Mount volume 1 of the set of backup archives. 

2. Type the xrestore command with the appropriate key and argu¬ 
ments. 

3. xrestore will check xdumpdir, then announce whether or not it 
found the files, give the numeric name that it will assign to the 
file, and in the case of a tape, rewind to the start of the archive. 

4. It then asks you to “mount the desired tape volume”. Type the 
number of the volume you choose. On a multivolume backup, 
the recommended procedure is to mount the last through the 
first volumes, in that order, xrestore checks to see if any of the 
requested files are on the mounted archive (or a later archive, 
thus the reverse order). If the requested files are not there, xre¬ 
store doesn’t read through the tape. If you are working with a 
single-volume backup or if the number of files being xrestored 
is large, respond to the query with 1 and xrestore will read the 
archives in sequential order. 

X Same as x except that files are replaced in original location. When 
you use this option, omit the initial slash (/) in the filename on the 
xrestore command line. 

The r option should only be used to xrestore a complete backup 
archive onto a clear file system, or to xrestore an incremental backup 
archive onto a file system so created. It should not be used to xrestore 
a backup archive onto the root file system. Thus: 

/etc/mkfs /dev/hdl 10000 
xrestore r /dev/hdl 

is a typical sequence to xrestore a complete backup. Another xrestore 
can be done to get an incremental backup in on top of this. 

A xbackup followed by a mkfs and a xrestore is used to change the 
size of a file system. 
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XRESTORE (ADM) 


Files 


rst* Temporary files 

/etc/default/restor Name of default archive device 

The default archive unit varies with installation. 

Notes 


It is not possible to successfully xrestore an entire active root file sys¬ 
tem. 

Note also that xrestore may be unable to xrestore more than one 
filesystem from the tape devices IdevInrctO and Idev/nrct2. 

Diagnostics 

There are various diagnostics involved with reading the archive and 
writing the disk. There are also diagnostics if the i-list or the free list 
of the file system is not large enough to hold the dump. 

If the dump extends over more than one disk or tape, xrestore may ask 
you to change disks or tapes. Reply with a newline when the next unit 
has been mounted. 

See Also 


xbackup(ADM), dumpdir(ADM), fsck(ADM), mkfs(ADM), sddate(C) 

Value Added 


xrestor and xrestore are extensions of AT&T System V developed by 
the Santa Cruz Operation. 
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XTD(ADM) 


xtd_ 

extract and print xt driver link structure 

Syntax 

xtd [-f] [-n ...] 

Description 


The xtd command is a debugging tool for the xr(HW) driver. It per¬ 
forms an XTIOCDATA ioctl{ S) call on its standard input file to extract 
the link data structure for the attached group of channels. This call 
will fail if data extraction has not been configured in the driver or the 
standard input is not attached to an jtf(HW) channel. The data are 
printed one item per line on the standard output. The output should 
probably be formatted via pr -3. 

The optional flags affect output as follows: 

-n n is a number in the range 0 to 7. Channel n is included in 

the list of channels to be printed. The default prints all 
channels, whereas the occurrence of one or more channel 
numbers implies a subset. 

-f Causes a “formfeed” character to be put out at the end of 

the output for the benefit of page-display programs. 

Diagnostics 


Returns 0 upon successful completion; 1 otherwise. 

See Also 


pr(C), xts(ADM), xtt(ADM), xt(HW), ioctl(S), xtproto(M) 
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XTS(ADM) 


xts___ 

extract and print xt driver statistics 

Syntax 

xts [-f] 

Description 

The xts command is a debugging tool for the xt(HW) driver. It per¬ 
forms an XTIOCSTATS ioctl(S) call on its standard input file to 
extract the accumulated statistics for the attached group of channels. 
This call will fail if statistics have not been configured in the driver, 
or the standard input is not attached to an i/(HW) channel. The statis¬ 
tics are printed one item per line on the standard output. 

-f Causes a “formfeed” character to be put out at the end of 

the output for the benefit of page-display programs. 

Diagnostics 


Returns 0 upon successful completion; 1 otherwise. 

See Also 


xtd(ADM), xtt(ADM), xt(HW), ioctl(S), xtproto(M) 
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XTT(ADM) 


xtt_ 

extract and print xt driver packet traces 

Syntax 

Xtt [-f] [-0] 

Description 


The xtt command is a debugging tool for the xr(HW) driver. It per¬ 
forms an XTIOCTRACE ioctl( S) call on its standard input file to turn 
on tracing and extract the circular packet trace buffer for the attached 
group of channels. This call will fail if tracing has not been config¬ 
ured in the driver, or the standard input is not attached to an jcr(HW) 
channel. The packets are printed on the standard output. 

The optional flags are: 

-f Causes a “formfeed” character to be put out at the end of the out¬ 
put for the benefit of page-display programs. 

-o Turns off further driver tracing. 

Diagnostics 


Returns 0 upon successful completion; 1 otherwise. 

Note 


If driver tracing has not been turned on for the terminal session by 
invoking layers(C) with the -t option, xtt will not generate any output 
the first time it is executed. 

See Also 



layers(C), xtd(ADM), xts(ADM), xt(HW), ioctl(S), layers(M) 
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